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Preface 


DECnet-—DOS is a set of softwaré communication products that enables individual 
computer systems, such as your personal computer, to communicate with one another 
in a network. The individual systems within a network are called nodes. 


The term DECnet—DOS refers to the following two products: 


e DECnet-—DOS, Version 1.1 for the IBM PC, PC/XT, and Personal Computer AT 
(running the IBM PC DOS Version 2.10 or 3.10 operating systems). 


e DECnet-—Rainbow, Version 1.1 for the Rainbow 100 computers running the Rain- 
bow MS-DOS Version 2.11 operating system. (DECnet-—Rainbow V1.1 does not 
support Ethernet configurations.) 


The term DOS refers to the following two operating systems: 


e MS-DOS running on the Rainbow personal computer. 


e IBM Personal Computer DOS (PC DOS) running on the IBM PC, the IBM PC/XT, 
and the IBM PC AT. 


Manual Objectives 


The DECnet-—DOS User’s Guide describes the DECnet—DOS software product and the 
eight utilities you can use with DECnet—DOS. 


The guide assumes that you are familiar with the use of the Rainbow or IBM personal 
computers, and the MS-DOS or PC DOS operating system. Throughout this guide, the 
term computer refers to the Rainbow personal computer as well as the IBM PC, the IBM 
PC/XT, and the IBM PC AT. 
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Intended Audience 


This manual is intended for users who want to expand the capabilities of their Rainbow 
and/or IBM personal computers in order to share data and resources with other DECnet 


systems. 


Structure of this Manual 


This manual consists of 7 chapters, 4 appendices and one glossary: 


Chapter 1 


Chapter 2 


Chapter 3 


Chapter 4 


Chapter 5 


Chapter 6 


Chapter 7 


Appendix A 


Appendix B 
Appendix C 
Appendix D 


Glossary 


Preface-—2 


Introduces the capabilities of DECnet—DOS. It also defines some basic 
concepts within a DECnet environment and introduces the eight DEC- 
net—DOS utilities. 


Describes how to use the Network Control Program (NCP) to set up 


your personal computer as a node in a DECnet network. It also explains 


how to use NCP to obtain detailed information about the network. 


Describes how to use the Network File Transfer utility (NFT) to access 
files on other nodes in the network. This chapter also discusses the File 
Access Listener (FAL) and the Job Spawner. 


Describes how to use the SETHOST utility to connect to another node 
in the network so you can access that node’s resources. 


Describes how to use the Network Device Utility (NDU) to set up disk 
drives and use printers on remote nodes. 


Describes how to use the DECnet-DOS Mail Utility for sending mail 
messages and text files to other nodes in the network. 


Describes how to use the Network Test Utility (NTU) to test the net- 
work hardware and software. 


Lists the error messages you can receive while using NCP. 
Lists the error messages you can receive while using NFT. 
Lists the error messages you can receive while using SETHOST. 
Lists the error messages you can receive while using NDU. 


Contains a list of DECnet—DOS terms. 


Graphic Conventions Used in This Document 


The following graphic conventions are used in this manual: 


Convention 


monospaced type 


UPPER CASE 


UPPERCASE 


italics 


{ $ 


( ) 


vertical 
list of 
options 


KEY 


Meaning 


Monospaced type indicates examples of system output or user 
input. System output is in black; user input is in red. 


Represents acceptable abbreviations, for example DELETE. The 
abbreviations are displayed as bold characters. 


Uppercase in commands and examples indicates that you should 
enter the characters as shown (enter either uppercase or lower- 
case). 


Italics in commands and examples indicate that either the system 
supplies or you should supply a value. 


Braces indicate that you are required to specify one (and only one) 
of the enclosed options. Do not type the braces when you enter 
the command. 


Square brackets indicate that the enclosed data is optional. (If a 
vertical list of options is enclosed, you can specify only one 
option.) Do not type the brackets when you enter the command. 


Parentheses enclose a set of options that must be specified 
together. 


A vertical list of options not enclosed within braces, brackets or 
parentheses indicates that you specify any number of options (or 
in some cases, none if defaults apply.) 


Indicates that you should press the specified key. indicates 
that you should hold down the key while you press the x 
key, where x is a letter. 


Note that unless otherwise specified, you should end every com- 
mand line by pressing the key. On the Rainbow personal com- 
puter, this key is labeled Return. On the IBM personal computer, 
this key is labeled —. 
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Associated Documents 


The following documents are included in the documentation set if you are using a Rain- 
bow computer. 


DECnet-Rainbow Installation Guide 
DECnet—DOS Getting Started 

DECnet—DOS User’s Guide, which you are reading 
DECnet—DOS Programmer’s Reference Manual 
DECnet—DOS Mini-Reference Guide 


DECnet—Rainbow Release Notes 


You should also have the following manuals available for reference: 


The installation guide and introductory manuals for your computer. 


The following documents are included in the documentation set if you are using an 
IBM personal computer. 


DECnet-DOS Installation Guide 

DECnet—DOS Getting Started 

DECnet—DOS User’s Guide, which you are reading 
DECnet—DOS Programmer’s Reference Manual 
DECnet—DOS Mini-Reference Guide 
DECnet—DOS Release Notes 


You should also have the following manuals available for reference: 


The installation guide and introductory manuals for your computer. 


Preface—4 


1 


Overview of DECnet-DOS 


This chapter introduces: 
e DECnet terms and concepts. 
e Network capabilities provided by DECnet-DOS. 


e ©The eight DECnet—DOS utilities you can use. 


1.1 DECnet Terms and Concepts 


Digital’s DECnet products connect individual computer systems, such as your personal 
computer, together in flexible configurations called networks. Individual systems ina 
network, called nodes, share resources and exchange information, files, and pro- 
grams. 


There is a different DECnet product for each Digital operating system. For example: 
e DECnet-—VAX is used on VAX computers running the VAX/VMS operating system. 


e PRO/DECnet is used on Professional computers running the P/OS operating sys- 
tem. 


e DECnet—Rainbow is used on the Rainbow personal computer running the MS-DOS 
operating system. 


e DECnet—DOS is used on the IBM PC, the IBM PC/XT or the IBM Personal Computer 
AT running the PC DOS operating system. 
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NOTE 


In this document, the term DECnet—DOS refers to the software on | 
both the Rainbow and IBM personal computers. wo 


Figure 1—1 shows DECnet—DOS in a DECnet network. 
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Figure 1-1: A Sample DECnet Network 
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Figure 1-1 shows an end node connected to a VAX computer. In a DECnet—DOS envi- 
ronment, an end node can also be called the local node and the executor node. 


e An end node can receive and transmit information for its own use. It cannot 
receive and then forward information intended for other nodes. 


e Alocal node is the node you are working on when you enter commands at the key- 
board. 


e An executor node is a node that performs network management functions. This 
node enables you to obtain information about the network. 


From the vantage point of the personal computer shown in Figure 1-1, the other net- 
work nodes in the diagram are called remote nodes. Two other terms define the VAX 
node in particular: 


e Adjacent node 


An adjacent node is a node that is physically connected to your local node by a sin- 
gle line. 


e Routing node 


The adjacent node shown in Figure 1-1 is a routing node. A routing node automati- 
cally forwards (or routes) information, files, and programs between nodes in the 
network. This allows the end node to copy data to and from any other node in the 
network. An end node cannot automatically receive and then forward data 
intended for another node. 


In a DECnet—DOS environment, you can set up your node as either: 
1. Anasynchronous DDCMP DECnet end node, using the communications port. 
OR 


2. An Ethernet end node, using a vendor-supplied Ethernet communications board 
and Ethernet hardware to connect to a Local Area Network (LAN). 


Note that DECnet—Rainbow only supports asynchronous communication. DECnet— 
DOS supports both asynchronous and Ethernet communication. 


1.2 DECnet-DOS Capabilities 
DECnet—DOS provides the following capabilities: 


e Network management, which allows you to control, monitor, and test DECnet-— 
DOS software. You can reconfigure your network as the need arises. 


e Remote file access, which allows you to access files on remote nodes. You can 
store and retrieve information on remote nodes. By storing the most current ver- 
sion of a file on a remote node, you eliminate the need for keeping a version of the 
file on each node. 
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File transfer, which allows you to exchange files with other nodes. This speeds up 
the information flow between organizations and decreases the amount of paper- 
work. 


Resource sharing, which eliminates the need for duplicating resources at each 
node. With resource sharing, many nodes can use the same printers, storage facili- 
ties, and processing capabilities. 


Resource server functions, which provide services to other nodes in the network 
(for example: file storage). 


Mail, which allows you to send messages to other nodes in the network. 


1.3 DECnet-DOS Utilities 


The following list is a summary of the DECnet—DOS utilities you can use. 
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Network Control Program (NCP) 


NCP allows you to perform network management. NCP is run as a part of the instal- 
lation procedure before you can use your pc as a node in the DECnet network. NCP 
is discussed in Chapter 2 of this guide. 


Network File Transfer (NFT) utility 


NFT allows you to transfer files between your local node and remote nodes within 
the DECnet network. NFT also provides other file-related services. NFT is dis- 
cussed in Chapter 3 of this guide. 


File Access Listener (FAL) 


FAL provides access to your computer from other nodes in the network. FAL is dis- 
cussed in Chapter 3 of this guide. 


Job Spawner 


The job spawner allows your computer to act as a server for multiple service func- 
tions. The spawner activates FAL and DTR to run on your node. The job spawner is 
discussed in Chapter 3 of this guide. 


SETHOST utility 


SETHOST, with network virtual terminal services, allows you to log on to a host 
node. You can use your personal computer as if it were directly connected to the 
host node, and use the host’s resources. SETHOST is discussed in Chapter 4 of this 
guide. 
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e Network Device Utility (NDU) 


NDU allows you to define virtual disk drives and virtual printers on remote sys- 
tems. NDU capabilities include: 


- Defining disks on a remote system and using them as if they were directly con- 
nected to your computer. 


— Allows you to direct text to a remote node to be queued later for printing. 
NDU is discussed in Chapter 5 of this guide. 
e DECnet-DOS Mail Utility 


The Mail utility lets you send mail messages and text files across the network. The 
Mail utility is described in Chapter 6 of this guide. 


e Network Test Utility (NTU) 


NTU tests the network hardware and software. NTU provides a subset of proce- 
dures associated with NCP. NTU is discussed in Chapter 7 of this guide. 
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Using the Network Control Program (NCP) 


The Network Control Program (NCP) is the DECnet management utility that accepts 
commands from your terminal to perform the following set of functions: 


Identify your personal computer to the rest of the network. 


Establish node names and default access control information for other nodes in the 
network. 


Establish access control information for allowing local file access. 


Change parameters which control how the hardware and software provide net- 
work services. 


Monitor network activity. 


Monitor network error counters. 


This chapter describes: 


Running NCP (see Section 2.1). 

General NCP command formats (see Section 2.2). 

Typing NCP commands (see Section 2.3). 

Getting help (see Section 2.4). 

Identifying your node to other nodes in the network (see Section 2.5). 


Establishing node names and access control information for other network nodes 
(see Section 2.6). 


Obtaining network information (see Section 2.7). 


2-1 


QM) 
Oct 
2D 

Z 
ae 
oS] 
ovo Mm 
7 
O= 
QO © 
D 
PA 
= 


Changing network information (see Section 2.8). 


Each NCP command, its format and usage (see Section 2.9). 


It is required that you know the person responsible for your network. If you have ques- 
tions regarding your node or the network, this person should be able to provide you 
with extra information or assistance. 
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Running the NCP Utility 


To run the NCP utility, you need to use NCP commands. You can supply NCP com- 
mands by using one of two methods: 
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Single command method: 


Enter a command string that includes NCP followed by the name of the specific 
NCP command. Press the REDkey. After each NCP command is entered, the MS- 
DOS prompt is returned. 


E>NCP command(RET) 
E> 


This method can also be used for entering commands from redirected input files. 
To enter commands from a file, enter a command string that includes NCP fol- 
lowed by the @ sign and the name of the file. Then press the REDkey. 


E>NCP @f i | e—name(RET) 
NOTE 


The SET ECHO command allows you to specify whether a redi- 
rected input file is displayed on your screen as the file is executed. 
(See Section 2.9.17 on how to turn echo on and off using the SET 
ECHO command.) 


When NCP has finished, an error level value is returned that can be 
used by the IF ERRORLEVEL statement in batch files. If NCP has 
successfully run, a value of O is returned. If the execution was 
unsuccessful, a value greater than 0 is returned. 


Multiple command method: 


You supply the name of the utility (NCP) and press the REDkey. NCP then responds 
with its own prompt. (You cannot use this method for submitting NCP commands 
in batch mode). 


E>NCP(RET ) 
NCP> 


Enter the NCP command after the NCP prompt and press the QET)key. Continue 
this procedure until you have entered all NCP commands. 


NCP>command(RET) 
NCP>command(RET ) 
NCP>command(RET) 
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2.1.1 Exiting from NCP 


To exit from NCP, you can use one of several NCP commands. The EXIT and 
(CTRLUZ)commands have the same effect, whereas, the QUIT command has a different 
result. 


Enter the EXIT command and press the REDkey. The system returns with the MS-— 
DOS prompt. You can also use CTRUZ)to exit from NCP. While holding down the 
(CTRL)key, press the letter Z key. Then press the REDkey. 


If you exit from NCP using either EXIT or CTRUZ, any permanent parameter 
changes that you made with SET and/or DEFINE commands are saved in the 
DECPARM.DAT file. 


NCP>EX I TET) 

The MS-DOS prompt is returned. 

E> 

Enter the QUIT command and press the REDkey. 

NCP>QU I T(RET) 

If you have made any changes, the system responds with: 

Do you want to save changes to permanent databases (Y or N) ? 


If you answer Y, all current changes to executor, circuit and line parameters are 
saved in DECPARM.DAT. If you answer N, the changes will not be saved. When 
you reboot your system, the network process checks to see if there is a 
DECPARM.DAT file. If the file does not exist, the process initializes using its own 
set of default parameters. 


The system responds with the MS-DOS prompt: 
E> 
Use 


Typing CTRUC will also cause NCP to exit, without saving any of the changes you 
made. 
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2.2 General Command Format 


Most NCP commands consist of three parts: the command verb, an entity on which the 
command operates, and one or more parameters that further qualify the action to be 
taken. For each command, you must supply the verb, one entity and (usually) one or 
more parameters or qualifier. Generally, the order in which you specify parameters 
does not matter. 


Examples of the NCP command format follow: 


Command 

Verbs Entities Parameters 
CLEAR NODE node-daddress All 

SET LINE line-id STATE ON 


It is not necessary to understand the details of the command format. However, you 
should be able to recognize the parts of each command. The following example shows 
parts of an NCP command: 


NCP>SHOW NODE PARIS CHARACTERISTICS TO NODE.LIS(RET) 
verb entity parameter qualifier 


Eleven command verbs are used with the NCP utility. Each verb causes NCP to take a 
different action: 


e CLEAR removes or clears parameters for a specific node or the executor. 


e COPY copies the node database to another file (without the access information). 
This is useful for making master copies of the DECNODE.DAT file for distribution. 


e DEFINE establishes specific parameters which take effect after you reboot your 
system. 


e EXIT allows you to exit from NCP and save parameter changes. 


e HELP provides on-line information about the NCP utility and specific com- 
mands. 


e MONITOR continuously displays event logging information on the terminal 
screen. 


e¢ QUIT allows you to exit from NCP, and gives you the choice of saving parameter 
changes. 


e READ displays event logging information on your terminal screen. You can also 
redirect it to a specified output file. 


e SET establishes specific parameters for a network entity. 
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e SHOW displays parameters that you defined with the SET or DEFINE command. It 
also displays counters and other parameters that cannot be set, and may be redi- 
rected to a specific output file. 


e ZERO zeroes the counters associated with a specific network entity. 


If you exit from NCP using EXIT or (TRUZ), the permanent executor, circuit, and line 
parameters set with the SET or the DEFINE command are saved in the file 
DECPARM.DAT (for use at next reboot). 


If you exit from NCP using the QUIT command, you choose whether to save or ignore 
permanent parameter changes for next reboot. Note that changes made using the SET 
command always become effective immediately. (See Section 2.1.1 on how parameter 
changes are affected when you use the QUIT command.) 


Although you can use both DEFINE and SET to modify network parameters, each com- 
mand has a different result when you issue it. The DEFINE command establishes spe- 
cific parameters, but they will not take effect until the next time you reboot your sys- 
tem. DEFINE lets you restore any default parameters that you may have temporarily 
changed with the SET command. SET also establishes specific parameters, but the 
changes take effect as soon as the commanzd is issued. (Some parameters changed by the 
SET command retain their values after the next reboot while some do not. Refer to Sec- 
tions 2.9.15 through 2.9.22 for more information about SET commands.) 


2.3 Typing NCP Commands 


To type an NCP command, enter the command at the NCP command prompt. You can 
abbreviate command keywords to three or more unique characters. (An exception to 
this is the use of the commands LINK and LINE. The first three characters for each com- 
mand are the same, so that you must use all four characters to properly identify the 
command you want to use.) 


For example, you can type SHO for SHOW. However, for clarity and consistency, all 
examples in this chapter show the full command format. 


2.4 Using the HELP Command 


In order to use the HELP command, the file NCPHELP.BIN must be in the same direc- 
tory as DECPARM.DAT. If you need assistance in selecting NCP commands, type HELP, 
then press the key. For example: 


NCP>HELP(RET) 


The system responds with: 

The HELP command displays information about NCP commands on your screen. 
HELP is available for the following commands: 

@ ; CLEAR COPY DEF INE EXIT MONITOR 

QUIT READ SET SHOW ZERO 
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You can also type the name of a specific command for which you want help informa- 
tion. For example: 


NCP>HELP CLEAR(RET) 
The system responds with: 


HELP is available for the following commands: 
CLEAR ACCESS CLEAR KNOWN ACCESS CLEAR EXECUTOR CLEAR NODE 


You can also get additional help on a particular NCP command. For example, if you 
want more information on the CLEAR EXECUTOR command, type: 


NCP>HELP CLEAR EXECUTOR(RET) 
The system responds with: 


Removes specified executor node parameters from the local node's 
database (DDCMP only). 


RECEIVE PASSWORD Password the executor node must receive 
from the adjacent node in order to exchange 
messages. 


TRANSMIT PASSWORD Password the executor node must transmit 
to the adjacent node in order to exchange 
messages. 


2.5 Defining Your Node Name and Address 


You must choose a name and address to identify your node to other nodes in the net- 
work. Each node has a unique name and address. In most cases, you obtain your node 
name and address from a person in your facility. The person handling network activi- 
ties must keep a list of all node names and addresses to ensure there is no duplica- 
tion. 


During software installation, your local node address and name are set when you per- 
form the installation procedure. (It is not necessary for you to repeat this step once 
installation is completed.) The DECnet-—DOS Installation Guideand the DECnet- 
Rainbow Installation Guideprovide a step-by-step explanation of the installation pro- 
cedure. 


If you need to change your node name and node address, you can change them with the 
DEFINE EXECUTOR command. The DEFINE EXECUTOR command establishes execu- 
tor characteristics that include node name and address. The executor’s node name and 
address become effective after the system has been rebooted. 


e <A node name is an identification string consisting of one to six alphanumeric 
characters, including at least one alphabetic character. For example: 


PARIS5 
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ee 


e Anode address is a unique numeric identification of a specific node. The node’s 
4 \ address includes an area number and a node number: 


area.number 
where 
area isanumber in the range of 1 to 63. 


number canbe in the range of 1 to 1023. It is separated from the area number with 
a period. 


For DECnet—DOS Version 1.1, your area number must match the area number of 
the node that is routing information for you. For asynchronous DECnet-—DOS, 
your area number must match the area number of your adjacent node. 


For example: 
2979 


Figure 2-1 illustrates the use of the DEFINE EXECUTOR command. A node name 
RAINBO is assigned to an area number 2.975. 


COMMAND 
a END NODE ROUTING NODE 


COMMAND 
OUTPUT 


EXECUTOR 
NODE RAINBO 


TWO243 


Figure 2-1: Defining Your Node and Address 
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2.6 Naming Remote Nodes 


At the local node, you create a list of the remote nodes that you want to access by name. 
This list can include access control information that allows you to access a specific 
node. To specify remote node information, use the SET NODE command. 


When you create a list of remote node names, the following information is required: 
e Node address 


A numeric string including the area number in the range of 1 to 63, and the node 
number in the range of 1 to 1023. If a node address is entered without an area num- 
ber, the default area number is that of the executor node. 


e Node name 


A character string consisting of 1 to 6 alphanumeric characters with at least one 
alphabetic character. 


2.6.1 Specifying Default Access Control Information 


Access control information allows you to access a specified remote node with the privi- 
leges of a specified user. This information includes: 


e Username 


A character string consisting of 1 to 39 alphanumeric characters that identifies the 
user at the remote node. 


e Password 


A character string consisting of 1 to 39 alphanumeric characters that may be 
required to access files or programs on the remote node. 


e Account 


A character string consisting of 1 to 39 alphanumeric characters. (This field is not 
used on most systems, including DECnet-DOS and DECnet-—Rainbow.) 


You can specify default access control information using NCP, or you can explicitly 
specify the information during a DECnet-—DOS operation. For example, when you 
specify access control data during an NFT session, this information is used by any fol- 
lowing command dealing with the same node. Once you exit from NFT, the access con- 
trol information is not saved. If you run NFT at another time, you cannot use the access 
control information that was set in a previous NFT session. However, you can use 
access control information previously specified with NCP. If NCP provides defaults 
and you decide to specify different values with NFT commands, these new values are 
used in place of the defaults. Refer to Chapter 3 of this manual for setting access control 
information during an NFT session. 
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You can also specify that the node you want to access is a LAT host node. Use the fol- 
lowing designation to specify this node: 


LAT-HOST Designate this node as a LAT host. 


If you specify default access control information using NCP, you can use the node 
name alone in network operations during a session involving a DECnet—DOS utility. 


To specify this information, use the SET NODE command. The SET NODE command 
assigns a node name plus access control information to a unique node address. (See Sec- 
tion 2.9.22 for more details on this command.) For example: 


NCP>SET NODE 2.375 NAME LONDON USER SMITH PASSWORD OPEN®ET) 


This command assigns node name LONDON to node address 2.375. It also specifies the 
user’s name as SMITH and the password as OPEN. 


When accessing a remote node only by node name, a DECnet—DOS utility follows this 
procedure to determine access control information: 


1. The utility sees if the data was specified with NCP. The utility checks the perma- 
nent database file, DECALIAS.DAT. Refer to the DECnet-—DOS Programmer's Ref- 
erence Manual for a description of the dnet__getalias() function call. 


2. If no access control data was specified using NCP, it is assumed that the remote 
node does not require access control information, and the requested operation is 
attempted. 


NOTE 


If you specify access control data with NFT, it is not necessary to 
specify the information again for use within the same NFT utility 
session. 


2.6.2 Changing and Overriding Default Access Information 


You can override the default access control information by specifying different infor- 
mation during a DECnet-—DOS utility session. The process of overriding default access 
control information during an NFT session is explained in Chapter 3 of this manual. 


If you want to change access defaults with NCP, you can use the SET NODE command. 
This command resets node parameters stored on the local node for the specified 
remote node. For example: 


NCP>SET NODE 2.31 NAME BOSTON USER SAM PASSWORD CAT(RET) 


This command sets different access control information for the node BOSTON. 
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2.6.3 Displaying Default Access Control Information 


The NCP SHOW KNOWN NODES command displays default access control informa- 
tion for a set of remote nodes. Figure 2-2 shows remote nodes in a sample DECnet-— 
DOS network. Each node has a specific node name. 


ASYNCHRONOUS 
LINE 
RB100 VAX 11/780 
_ cma case. 
POPIY73 PROSBO 
NODE PARISS 
ASYNCHRONOUS Nh gaa 
ne 


RB100 PC 
BOSTON NODE TEXAS 


Figure 2-2: Remote Node Names 


TWO0242 


To display information for the remote nodes that appear in Figure 2-2, type the NCP 
command, SHOW KNOWN NODES. This command displays the following informa- 
tion for nodes that are known to the local node RAINBO: 


® Node address 
e Node name 
e¢ Number of active logical links 


e Access control information (Output as account information) 
NCP>SHOW KNOWN NODES(RET) 
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The system responds with: 
Node Summary as of 1-SEP-1985 1:31:17 


Executor node 2.975 (RAINBO) 


State = On 

Identification = DECnet-DOS Office Group 
Node Node Active LAT Account 

Address Name Links Information 

Zann TEXAS 6) /DALLAS/... 

Z,a7 PARIS3 0O L /JOHN/... 

2.48 ROME 6) M SMITH «172345 
Zecio LONDON O LM /KEVIN/... 


2. Obtaining Network Information 


Using NCP commands, you can display the following network information on your 
screen: 


e Node, line and circuit parameters can be displayed by specifying CHARACTERIS- 
TICS with a specific network entity. 


e Node names, node addresses, and access control information for remote nodes can 
be displayed if they have been defined by the executor node. 


e Counters display statistics about the flow of network messages to and from your 
node. The counters also record error conditions and accumulate their totals for 
you. 


e A network event logger records network events. See READ LOGGING (Section 
2.9.14). 


e Network status (state) and other related information can be displayed for a specific 
node, line, or circuit. 
2./.1 Executor Node Information 


To display information about the executor node, type: 
NCP>SHOW EXECUTOR CHARACTERIST ICS(RET) 


This command summarizes the network parameters that you specified for the executor 
node. 


2./.2 Remote Node Information 


To determine if you defined a specific node with the SET NODE command, type: 
NCP>SHOW NODE node-id(RET) 
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This command displays the node name, node address, access control information, and 
the number of active logical links for node node-id from this node. 


If you want information only for nodes with active logical links, type: 
NCP>SHOW ACTIVE NODES(RET) 


This command displays the node name and address, the access control information, 
and the number of active links from this node to the adjacent node and any other nodes 
with active logical links to your node. The executor node is always displayed. 


2.7.3 Line Information 


In the context of DECnet—DOS, a line is the physical line connecting the local node 
with the adjacent node. There are two possible line states: 


e ON - The line is ready for use. To determine if the line is working properly, use the 
SHOW LINE CHARACTERISTICS command. (See Section 2.9.27 for an explana- 
tion.) 


e OFF - The line’s database and parameters are present, but the line is not available 
for any type of network activity. 


There are three substates controlled through network management. They can only be 
observed when the LINE STATE is ON. Use the SHOW LINE CHARACTERISTICS com- 
mand to display line substates. The substates are: 


e SYNCHRONIZING - The line is to be or is being initialized. 
e RUNNING - The line is in normal running state. 
e SERVICE - The line is reserved for loopback testing. 


To display status information about the physical line, type: 
NCP>SHOW LINE STATUS(RET) 


This command displays the current status of the line. 


2.7.4 Circuit Information 


In the context of DECnet-—DOS, a circuit is the communications path established 
between the local node and its adjacent node. There are two possible circuit states: 


e ON - The circuit is ready for use. To determine if the circuit is working properly, 
use the SHOW CIRCUIT CHARACTERISTICS command. (See Section 2.9.23 for an 
explanation.) 


e OFF - The circuit’s database and parameters are present, but the circuit is not avail- 
able for any type of network activity. 
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There are three substates controlled through network management. Use the SHOW 
CIRCUIT CHARACTERISTICS command to display circuit substates. The substates are: 


SYNCHRONIZING - The circuit is being initialized. 
STARTING - The circuit is initialized. 
RUNNING - The circuit is in running state. 


To display status information about the circuit, type: 
NCP>SHOW CIRCUIT STATUS(RET) 


This command displays the current status of the line. 


2.8 Changing Network Information 


Using NCP commands, you can change the executor node, line, and circuit parameters 
according to the needs of your network. It is recommended that you do not change the 
settings for these parameters unless you are familiar with DECnet concepts. 


The following network parameters are some of the features that you can change: 


At Installation 


Executor node name and address 


The node name is a one to six alphanumeric character string associated with a spe- 
cific node address. The string must contain at least one alphabetic character. The 
node address is a numeric string that identifies the location of the node in the net- 
work. 


Line speed (applies to asynchronous DDCMP lines only) 


The speed of the communications line can be set to a specific baud rate. Line speed 
is the rate at which signals are transmitted over a communications line. 


During Use 


Line state 


The state of the communications line can be either ON or OFF. See Section 2.7.3 
for an explanation of states and substates. 


Seldom Changed 


Segment buffer size 


Every node in the network uses areas in memory, called buffers, for temporary 
storage of data. The buffers hold information being transferred to and from each 
node. 


The segment buffers are used for transmitting DECnet messages. The segment 
buffer size defines the amount of information that a node can process from the 
buffer at one time. Do not change the segment buffer size unless you are very famil- 
iar with DECnet concepts. 
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Maximum number of buffers 


This parameter defines the maximum number of buffers available for each node. 


Increasing the number can increase performance. However, it also uses more mem- 
ory space. 


Access control information 


Access control information is security information that allows you to access a spe- 
cific remote node. This information includes node name, user name, password, 
and accounting information. 
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2.9 NCP Command Summary 


The remainder of this chapter is devoted to descriptions of the individual NCP com- 
mands and their parameters. The commands are discussed in alphabetical order. Table 


2-1 lists the NCP commands. 
Table 2-1: NCP Commands 


Command 


CLEAR ACCESS 


CLEAR EXECUTOR 


CLEAR KNOWN ACCESS 


CLEAR NODE 


COPY KNOWN NODES 


DEFINE CIRCUIT 


DEFINE EXECUTOR 


DEFINE LINE 


EXIT 
HELP 


MONITOR LOGGING 


QUIT 


READ LOGGING 


SET ACCESS 
SET CIRCUIT 


SET ECHO 


Function 


Clears the incoming access information for the designated 
user. 


Removes executor node parameters stored on the local 
node. 


Clears the entire access database. 
Removes remote node parameters stored on the local node. 


Copies the node database (in DECNODE.DAT) to the speci- 
fied file. Access information is not copied. 


Defines the circuit characteristics which will take effect the 
next time you reboot your system. 


Defines executor node characteristics which will take 
effect with the next system reboot. 


Defines the state of the line. It becomes effective with the 
next system reboot. 


Allows you to exit from NCP and save parameter changes. 
Displays asummary of NCP commands on your screen. 


Displays event logging information on the screen in front of 
you. 


Allows you to exit from NCP, and gives you the choice of 
saving parameter changes. 


Displays the contents of the event logging buffer on the 
screen in front of you. 


Sets incoming access information for the designated user. 
Defines or modifies circuit information. 


Displays the contents of a batch file or a redirected file on 
your screen as the file is executed. 


(continued on next page) 
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Table 2-1 (cont.): NCP Commands 


Command 


SET EXECUTOR 


SET KNOWN LINKS 
SET LINE 


SET LINK 


SET NODE 


SHOW CIRCUIT 
SHOW EXECUTOR 
SHOW KNOWN ACCESS 
SHOW KNOWN LINKS 
SHOW LAT 

SHOW LINE 

SHOW LINK 

SHOW NODE 

ZERO CIRCUIT 

ZERO EXECUTOR 
ZERO LAT 


ZERO LINE 
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Function 


Defines or modifies the executor node’s parameters or . 
characteristics. 


Breaks all links and frees the associated sockets. 
Defines or modifies the line’s parameters or characteristics. 


Terminates the logical link connections that are associated 
with a specific socket. The socket is also detached. 


Assigns a node name plus access control information to a 
unique node address. 


Displays circuit information. 

Displays executor node information. 

Displays incoming access information. 

Displays all the current logical links. 

Displays counters for LAT (applies to LAT line only). 
Displays line information. 

Displays logical link status information. Na 
Displays remote node information. 

Zeroes the counters for the circuit. 

Zeroes the counters for the executor node. 

Zeroes counters for LAT (applies to LAT line only). 


Zeroes the counters for the line. 
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2.9.1 Standard Definitions 


Table 2-2 lists variables and parameters that are frequently used in NCP commands. 
They are described here to avoid needless repetition in the command descriptions on 


the following pages. 


Table 2-2: NCP Command Parameters 


Parameter 


circuit-id 


device-id 


line-id 


node-id 


node address 


node name 


CHARACTERISTICS 


COUNTERS 


STATUS 


SUMMARY 


TO file-id 


Function 


specifies circuit ASYNC-1 or ETHER-1. Since there is only one cir- 
cuit to use for each configuration in both DECnet-—DOS V1.0 and 
DECnet-—DOS V1.1, the circuit-id is optional. 


specifies the device for controlling the DECnet line (if you are using 
asynchronous DECnet). For the Rainbow, the device is COM-—1. For 
the IBM PCs, the device can be either COM-1 or COM-2. 


specifies line ASYNC-1 or ETHER-1. Since there is only one line to 
use for each configuration in both DECnet-DOS V1.0 and DECnet-— 
DOS V1.1, the Jine-id is optional. 


specifies a node address (see node address) or a node name (see node 
name). 


specifies a unique decimal string consisting of an area number in the 
range of 1 to 63, followed by a period and a node number in the 
range of 1 to 1023. 


specifies a string of 1 to 6 alphanumeric characters, including at least 
one alphabetic character. 


displays parameters that are currently set for the executor, line, or 
circuit. 


displays error and traffic information for the executor, line, or cir- 
cuit. 


A counter displays statistics about the flow of network messages for 
your node. The counters also tabulate recorded error conditions. 


Traffic refers to messages traveling over the line between nodes. 


displays the availability of the executor, line, or circuit for network 
activity. 
displays only the most useful information for the executor, line, cir- 


cuit, or links. SUMMARY is the default display type. 


specifies the name of an output file to which SHOW or READ infor- 
mation is to be directed. 
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2.9.2 CLEAR ACCESS 


The CLEAR ACCESS command removes incoming access information for the desig- 


nated user. The access information is stored on a per user basis, and it includes the pass- 
word and access type. 


Format 

CLEAR ACCESS USER username 

where 

username isa 1 to 39 alphabetic character string that defines the user. 
Example 


The following example removes the entire entry for the user BARKER. 
CLEAR ACCESS USER BARKER(RET) 
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2.9.3 CLEAR KNOWN ACCESS 


The CLEAR KNOWN ACCESS command clears all of the incoming access information 
in the database. This allows you to delete all access information for all users, rather 
than clearing it for one designated user (as with CLEAR ACCESS). 


Format 
CLEAR KNOWN ACCESS 


Example 
NCP>CLEAR KNOWN ACCESS(RET) 
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2.9.4 CLEAR EXECUTOR 


The CLEAR EXECUTOR command removes specified executor node parameters from 
the local node’s database. 


Format 
CLEAR EXECUTOR ( RECEIVE PASSWORD 
TRANSMIT PASSWORD 

where 

RECEIVE PASSWORD removes the password the executor node must receive 
from the adjacent node in order to exchange messages 
with the adjacent node. 

TRANSMIT PASSWORD removes the password the executor node must transmit 


to the adjacent node in order to exchange messages 
with the adjacent node. 


NOTE 
These passwords are used for asynchronous DDCMP connections 
only. 
Remarks 


The RECEIVE and TRANSMIT passwords are automatically exchanged when the execu- 
tor or remote node turns on the communication line between itself and the adjacent 
node. The network coordinator defines these passwords (for DDCMP use). The 
exchange of passwords also occurs when the communications line is restarted (from 
either node) due to errors. 


Example 
NCP>CLEAR EXECUTOR TRANSMIT PASSWORD(RET) 


This command removes the password that the executor node must transmit to the adja- 
cent node when the executor node first begins communications. Until the network 
coordinator defines a new transmit password, the executor node cannot open the com- 
munication line between itself and the adjacent node. 
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2.9.5 CLEAR NODE 


) | The CLEAR NODE command removes parameters stored on the local node for either 
the specified remote node or all remote nodes known to the local node. 


Format 
CLEAR KNOWN NODES 
or 
CLEAR NODE node-id [| ALL 
USER 
PASSWORD 
ACCOUNT 
LAT-HOST 
where 
KNOWN NODES removes node parameters (node name, node address, user ID, 
password and account) for all nodes known to the local node. 
NODE node-id specifies the node whose parameters are to be removed. 
ALL removes all parameters (node name/address and access control 
information) for the specified node. If you specify ALL, you 
a cannot include any other parameters. 
USER removes the username, password, and accounting information 
for the specified node. 
PASSWORD removes the password associated with the username. 
ACCOUNT removes the accounting information for the specified node. 
LAT-HOST removes the indicator that identifies the node as a LAT host. 
Example 


NCPS>CLEAR NODE PARIS ALL(RET) 


This command removes all parameters for node PARIS from the local node’s database. 
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2.9.6 COPY KNOWN NODES 


The COPY KNOWN NODES command copies the node database to a file. If the data- 
base contains access information, it is not copied. This command is useful if you want 
to copy your node database for another user, but you do not want to include any of the 
access information. 


Format 

COPY KNOWN NODES TO /file-id 

where 

TO file-id see definition in Section 2.9.1. 


Example 
NCP>COPY KNOWN NODES TO NODEDATA. DAT@ET) 


This example copies the node database to the file NODEDATA.DAT. 
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2.9.7 DEFINE CIRCUIT 


The DEFINE CIRCUIT command defines the characteristics for the circuit state. The 
state can either be ON or OFF. The characteristic you specify does not take effect until 
the next time you reboot your system. 


Format 


DEFINE CIRCUIT STATE(ON 
OFF 


Example 
NCP>DEFINE CIRCUIT STATE ON(RET) 


This example sets the circuit state to be ON for the next reboot. 
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2.9.8 DEFINE EXECUTOR 


The DEFINE EXECUTOR command sets executor characteristics that become effective 
after the next system reboot. 


Format 
DEFINE EXECUTOR ADDRESS node-address 
MAXIMUM BUFFERS number 
MAXIMUM LINKS number 
NAME node-name 
SEGMENT BUFFER SIZE number 
where 
ADDRESS node-address specifies the address assigned to the executor node. 
MAXIMUM BUFFERS specifies the maximum number of large network 
number communication buffers available for use by DECnet- 
DOS. The default is six times (6X) the number of 
links. The actual number of buffers is restricted by 
available memory. This affects the network response 
time and memory usage. 
MAXIMUM LINKS number specifies the maximum number of active logical links 
for the executor node. The valid range is 1 to 32. 
NAME node-name specifies the node name for the executor node. or 
SEGMENT BUFFER SIZE specifies the size of the segment buffers in bytes. 
number These buffers are used for transmitting DECnet mes- 
sages off the local area network only. (The segment 
size on the local area network is fixed.) The size is a 
decimal integer in the range of 1 to 65535. 
Examples 


NCP>DEFINE EXECUTOR ADDRESS 2.197(RET) 


This command sets the executor address to 2.197. 
NCPS>DEFINE EXECUTOR ADDRESS 2.197 NAME MOTHER(RET) 


This command sets the executor address to 2.197 and assigns the executor name to be 
MOTHER. 


NCP>DEFINE EXECUTOR MAXIMUM LINKS 6(RET) 


This command sets the maximum number of logical links for the executor node to 6. 
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2.9.9 DEFINE LINE 


( ) The DEFINE LINE command defines the state of the line at DECnet startup. It becomes 
effective with the next system reboot. 


Format 
DEFINE LINE STATE(ON 
OFF 
RECEIVE BUFFERS n 
where 
STATE defines the line’s reboot state to ON or OFF. When the line 


state is ON, the line is available for normal use. When the line 
state is OFF, the line’s database and parameters are present, 
but the line is not available for any type of network activity. 


RECEIVE BUFFERS n specifies the number of buffers to be used for receiving infor- 
mation. Increasing the number of buffers affects the network 
response time and memory usage (for use only in Ethernet 
communications). The valid range is 1 to 32. The default is 8. 


Examples 
NCP>DEFINE LINE STATE ON(RET) 


rr This example defines the line state to be ON. This causes the line to be ready for use at 
next reboot. 


NCP>DEFINE LINE RECEIVE BUFFERS 50(RET) 


This example sets the maximum number of receive buffers to use for Ethernet commu- 
nication to 50. 


cy 
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2.9.10 EXIT 


The EXIT command lets you exit from NCP and save any parameter changes that you | } 
made with the SET and/or DEFINE commands. These changes are saved in the 
DECPARM.DAT file. 


Format 
EXIT 


Example 
NCP>EX IT (RET) 
E> 


This example exits you from NCP and returns you to the prompt or system you were 
using previously. 


WO 
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2.9.11 HELP 


( | } The HELP command displays information about NCP commands on your screen. See 
Section 2.4 for full details and examples. 


Format 
HELP [command-verb[entity]] 
where 


command-verb specifies the NCP command for which you would like more informa- 
tion. 


entity specifies that you would like information about the specified com- 
| mand as it relates to this component. 


Example 
NCP>HELP CLEAR EXECUTORRET) 


This command causes HELP information to be displayed for the CLEAR EXECUTOR 
command. 


Cy 
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2.9.12 MONITOR LOGGING 


The MONITOR LOGGING command displays network events as they are being logged. 
An event is an occurrence that has potential significance in the operation and/or main- 
tenance of a network. Logging is the process that generates a record of the event. Cap- 
turing this information in a file can be useful to a network support person if network 
problems occur. Refer to READ LOGGING for more information on event recording. 


You can stop the display of information logging by pressing any key on the keyboard. 
(The logging will also stop when there are no more events to be displayed.) If you want 
to stop the display and also exit from NCP, type (TRU). The system requests verifica- 
tion with the prompt, ‘“‘Terminating process?’’. If you answer YES, NCP exits and 
returns you to the prompt or system you were using previously. If you answer NO, 
monitoring continues. 


For DECnet—DOS systems, event logging is always turned on, and you cannot select 
only certain events to be displayed. After the events are displayed or redirected, they 
are then discarded. 


If an event is lost, NCP displays an error message before displaying the rest of the 
logged events: 


Event type 0.0 Event records lost 


Each event can display the following information: 


Event type nn.nn Name of event type 
Occurred dd-mmm-yyyy hh:mm:ss 
Other event-dependent text 


Format 
MONITOR LOGGING [TO file-id] 
where 


TO file-id see definition in Section 2.9.1. 
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Example 
(ry NCP>MONITOR LOGGING(ET) 


The system responds with: 


Events logged as of 17-Jan-1986 11:17:41 
Event type 410 Circuit up 

Occurred 17-Jan-1986 11:18:00 

Adjacent Node: 55.2 (LOWEND) 


Event type 47 Circuit down -circuit fault 
Occurred 17-Jan-1986 11:18:09 

Adjacent Node: 55.2 (LOWEND) 

Reason: Line synchronization lost 


Event type 410 Circuit up 
Occurred 17-Jan-1986 11:18:15 
Adjacent Node: 55.2 (LOWEND) 


( 
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2.9.13 QUIT 


The QUIT command allows you to exit from NCP. At the same time, you have the 
option of either saving or deleting any parameter changes you made. 


Format 
QUIT 
Remarks 


If you issue the QUIT command and you have made any changes that may affect the 
database, NCP requests verification. For example: 


NCP>QU I T(RET) 
Do you want to save changes to permanent database (Y or N) ? 


If you answer YES, NCP saves the changes and stores them in the database file. NCP 
then exits. If you answer NO, the changes are not saved and NCP simply exits. 


Example 
NCP>QUIT(RET) 
C> 


In this example, no changes were made or saved, so NCP exits and returns you to the 
prompt or system you were using previously. 
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2.9.14 READ LOGGING 


The READ LOGGING command displays the contents of the 


may be redirected to a specified output file. 
Format 

READ LOGGING [TO /ile-id] 

where 

TO file-id see definition in Section 2.9.1. 


Example 
NCP>READ LOGGING(RET) 


The system responds with: 


Events logged as of 17-Jan-1986 11:17:41 
Event type 4.10 Circuit up 

Occurred 17-Jan-1986 11:18:00 

Adjacent Node: 55.2 (LOWEND) 


Event type 4.7 Circuit down —-circuit fault 
Occurred 17-Jan-1986 11:18:09 

Adjacent Node: 55.2 (LOWEND) 

Reason: Line synchronization lost 


Event type 4/0 Circuit up 
Occurred 17-Jan-1986 11:18:15 
Adjacent Node: 55.2 (LOWEND) 
End of log 
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2.9.15 SET ACCESS 


The SET ACCESS command sets incoming access information for the designated user. 
The access information is stored on a per user basis, and it includes the password and 
access type. 


If you want the characters representing the access information to be stored in upper- 
case letters, simply type the characters. If you do not want the characters to be stored 
as uppercase, place the string in quotation marks. For example: 


abc will be stored in the database as ABC 


"Aab” will be stored in the database as Aab 


Format 
SET ACCESS USER username 
PASSWORD password 
access-type 
where 
username is a 1 to 39 alphabetic character string that defines the user. 
password is a 1 to 39 alphabetic character string that defines the user’s pass- 
word. The default is no password. 
access-type describes the type of privilege the user has to access information on 
this node. There are four types of access. They are: 
e NONE - no access for this user. This is the default. 
e READ - provides read only access. 
e WRITE - provides write only access. 
e ALL —- provides both read and write access. 
Remarks 


The information you define with SET ACCESS is stored in the database DECACC.DAT. 
The DECACC.DAT file is used by FAL and other DECnet-—DOS utilities to limit access 
from remote systems. This file is also used by the dnet_getacc( _) function. (Refer 
to the DECnet-DOS Programmer’s Reference Manual for information on using the 
dnet functions.) 


Example 


The following example sets access information for the user BARKER. In this case, the 
password is JUMPER and the access type is READ. 


NCP>SET ACCESS USER BARKER PASSWORD JUMPER READ 
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2.9.16 SET CIRCUIT 


The SET CIRCUIT command defines or modifies circuit information. 


Most parameters are set by your network coordinator. Therefore, you must obtain this 
information from that person. 


Format 


SET CIRCUIT |circuit-id| 


where 


CIRCUIT [circuit-id| 


HELLO TIMER 
seconds 


OW NER 
DECnet 
MOP 


SERVICE 
DISABLED 
ENABLED 


STATE 
ON 


OFF 


Example 


HELLO TIMER seconds 
OWNER ( DECnet 
face | 
SERVICE ( DISABLED 
ropes } 
STATE(ON 
ores 


specifies the circuit (either ASYNC-1 or ETHER-1) for which 
parameters are to be defined or modified. 


specifies the frequency of routing hello messages sent to the 
adjacent node over the circuit. The valid range is 1 to 8191 
seconds. The default is 30. 


specifies the circuit owner. 
is the default setting. 


is required for running loopback tests via the Network Test 
Utility. (Refer to Chapter 7 for details on NTU.) 


sets the circuit’s service state. The default is ENABLED. 
specifies that the circuit is unavailable for service operations. 


specifies that the circuit is available for special network activ- 
ity such as loopback testing. 


sets the line’s operational state to ON or OFF. 


allows network traffic to flow over the circuit. This is the 
normal operational state. 


allows no traffic to flow over the circuit. The circuit is 
unavailable for any network activity. 


NCP>SET CIRCUIT ASYNC-1 OWNER DECnet(RET) 


This command identifies the owner of circuit ASYNC-1 as DECnet. 
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2.9.17 SET ECHO 


The SET ECHO command determines whether a redirected input file is displayed on 
your screen as the file is executed. The default is OFF (no echo). 


Format 
SET ECHO (ON 
OFF 
where 
ON turns the echo on, causing the file’s contents to be displayed on the 
screen as the file is executed. 
OFF turns the echo Off. 
Example 


NCP>SET ECHO ON(RET) 


This command causes the redirected input from a file to be displayed on the screen. 


UO 


2-34 DECnet-—DOS User’s Guide 


2.9.18 SET EXECUTOR 


The SET EXECUTOR command sets the executor node’s parameters or characteristics. 
Format 


SET EXECUTOR ADDRESS node-address 
DELAY FACTOR number 
DELAY WEIGHT number 
IDENTIFICATION id-string 
INACTIVITY TIMER seconds 
INCOMING TIMER seconds 
NAME node-name 
OUTGOING TIMER seconds 
RECEIVE PASSWORD password 
RECEIVE PIPE QUOTA number 
RETRANSMIT FACTOR number 
SEGMENT BUFFER SIZE number 
STATE ON 
TRANSMIT PASSWORD password 
TRANSMIT PIPE QUOTA number 


where 


ADDRESS node-address specifies the address assigned to the executor node. 
You can set ADDRESS only when the executor’s 
state is OFF. The executor’s state is OFF if the DEC- 
net network process fails to find the DECnet data- 
base file, DECPARM.DAT. 


DELAY FACTOR number determines the amount of time to wait before a mes- 
sage is retransmitted to a node. The number is deci- 
mal in the range of 1 to 65535. The default is 2. 


DELAY WEIGHT number is the weight to apply to a current round trip delay to 
a remote node when updating the estimated round 
trip delay to a node. The number is decimal in the 
range 1 to 255. The default is 1. 


IDENTIFICATION id-string specifies a text identification string for the executor 
node. The string can consist of 1 to 32 alphanumeric 
characters. You must use quotation marks (’) to 
delimit any string containing blanks or tabs. You can- 
not use a single quotation mark within the identifica- 
tion string. 


You can identify the executor node to other nodes in 
the network, for example, by including your name 
or department in the string. 
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INACTIVITY TIMER seconds 


INCOMING TIMER seconds 


NAME node-name 


OUTGOING TIMER seconds 


RECEIVE PASSWORD 
pPassword 


RECEIVE PIPE QUOTA 
number 


RETRANSMIT FACTOR 
number 


SEGMENT BUFFER SIZE 
number 


STATE ON 
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is the maximum duration of inactivity (no data in 
either direction) on a logical link before the node 
checks to see if the logical link still works. If no activ- 
ity occurs within the minimum number of seconds, 
the node generates traffic to test the link. The value 
range is 1 to 65535. The default is 30. 


is the maximum duration between the time a connec- 
tion request is received at the executor node, and the 
time that it takes to accept or reject the request. If the 
request is not accepted or rejected by the user pro- 
gram within the specified number of seconds, the 
connection request is automatically rejected. If no 
value is set, there is no timer. The default is 45. 


specifies the node name for the executor node. You 
can set NAME only when the executor’s state is OFF. 
The executor’s state is OFF if the DECnet network 
process fails to find the DECnet database file, 
DECPARM.DAT. 


is the duration between the time that the executor 
node requests a connection, and the time that it takes 
for the request to be acknowledged at the remote 
node. The default is 60. 


is the password the local node must receive from the 
adjacent node in order to exchange messages with 
the adjacent node. 


the number of segments the driver will allow to be 
received for a link by flow control. The valid range is 
1 to 32767. The default is 3. 


is the maximum number of times that the executor 
node will restart the retransmission timer when it 
expires. If the number is exceeded, the logical link is 
disconnected. The number is a decimal value in the 
range of 1 to 65535. The default is 3. 


specifies the size of the segment buffers in bytes. 
These buffers are used for transmitting DECnet mes- 
sages off the local area network only. (The segment 
size on the local area network is fixed.) The size is a 
decimal integer in the range of 1 to 65535. 


allows logical links to be established to the executor 
node. The executor’s state is OFF if the DECnet net- 
work process fails to find the DECnet database file, 
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Cy 


TRANSMIT PASSWORD 
password 


TRANSMIT PIPE QUOTA 
number 


DECPARM.DAT. You must SET EXECUTOR 
ADDRESS (and NAME, if desired) before you can SET 
EXECUTOR STATE ON. If you specify STATE ON, 
you cannot include any other parameters. 


is the password the local node must transmit to the 
adjacent node in order to exchange messages with 
the adjacent node. 


the number of segments the driver will buffer into 
NSP before it blocks the user on a transmission. The 
valid range is 1 to 32767. The default is 3. 


NOTE 


Information about RECEIVE PASSWORD and TRANSMIT PASSWORD 
applies to asynchronous DDCMP communications only. 


Examples 


NCP>SET EXECUTOR STATE ON(RET) 


This command sets the executor node’s state to ON. You must also turn the line state to 
ON with the SET LINE command. The node can then establish logical links with other 


nodes. 


NCP>SET EXECUTOR OUTGOING TIMER 10(RET) 


This command indicates that the executor node will wait 10 seconds between the time 
that a connection request is sent, and the time it takes for an acknowledgment to be 


sent by the destination node. 


NCP>SET EXECUTOR ADDRESS 4.4 NAME FOO(RET) 


This command sets the executor node’s address to 4.4 and its name to FOO. 
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2.9.19 SET KNOWN (or ACTIVE) LINKS 


The SET KNOWN (or ACTIVE) LINKS command breaks all link connections that are not 
set with the socket option, SO__KEEPALIVE, and frees the associated sockets. 


Format 


SET (KNOWN LINKS) STATE OFF 
ACTIVE LINKS 


where 


KNOWN LINKS breaks all current links whose sockets are not set with 
SO__KEEPALIVE. The sockets can be reassigned to other tasks. 


ACTIVE LINKS performs the same function as KNOWN LINKS. 
STATE OFF turns the logical link off. 
Remarks 


Use this command only if you are familiar with the socket level programming interface. 
Refer to the DECnet-DOS Programmer’s Reference Manual for additional informa- 
tion. 


Example 
NCP>SET ACTIVE LINKS STATE OFF(RET) 


This command aborts all current links and frees the associated sockets. 
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2.9.20 SET LINE 
The SET LINE command defines or modifies line information. 


Most parameters, such as the baud rate, are set by the person who coordinates activity 
on your network. Therefore, you must obtain this information from that person. 


Restrictions 


The executor state must be ON in order for you to define or modify any line parame- 
ters. In addition, the line state must be OFF if you wish to specify any parameters other 
than STATE OFF or RETRANSMIT TIMER. You must execute a SET LINE STATE OFF 
command before you define or modify any other line parameters. When you are fin- 
ished, execute a SET LINE STATE ON command to turn the line back on. 


Format 
SET LINE |line-id| DEVICE(COM-1 
COM-2 
MODEM ( NULL 
FULL 
SPEED baud-rate 
STATE (OFF 
ON 
where 
LINE [/ine-id]| specifies either ASYNC-1 or ETHER-1 as the line for which 


parameters are to be created or modified. 


SPEED baud-rate sets the DDCMP line speed to one of the following: 


50 150 1200 3600 
2 200 1800 4800 
110 300 2000 7200 
134 600 2400 9600 


A line speed of 7200 is not supported by the Rainbow 100A 
and B computer systems. 


STATE sets the line’s operational state to ON or OFF. 


DEVICE device-id specifies the device for controlling the line. The line’s circuit 
must be in the OFF state. For the Rainbow personal computers, 
the device is COM-1. For the IBM personal computers, the 
device can be either COM-1 or COM-2. 
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MODEM specifies the type of modem control to be used. Note that 
modem control is used only with asynchronous DDCMP con- 


nections. eas 


NULL specifies that modem control signals will not be checked. 


FULL specifies that modem control signals will be checked. The line 
will be shut down if the modem loses its connection. 


NOTE 


Information about modem and line speed applies to asynchronous 
DDCMP communications only. 


Example 
NCP>SET LINE ASYNC-1 SPEED 9600(RET) 


This command sets the speed of line ASYNC-1 to 9600. Note that line speed is set only 
if you are using asynchronous DDCMP connections. (Since there is only one line to use 
for each configuration in both DECnet-DOS V1.0 and DECnet-DOS V1.1, the Line-id is 
optional.) 


Y 
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2.9.21 SET LINK 


The SET LINK command terminates logical link connections that are associated with a 
specific socket. The socket is also detached. 


Format 
SET LINK socket STATE OFF 


where 


LINK socket specifies the socket to be detached. 
STATE OFF turns the logical link off. | 
Remarks | 


Use this command only if you are familiar with the socket level programming interface. 
If the socket option SO__KEEPALIVE has been set, the socket cannot be terminated. 
Refer to the DECnet—DOS Programmer’s Reference Manual for additional informa- 
tion. 

Example 

NCP>SET LINK 3 STATE OFF(RET) 


This command detaches socket 3 and breaks its logical links. To determine the socket 
number, use the SHOW KNOWN LINKS command. 
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2.9.22 SET NODE 


The SET NODE command assigns a node name plus access control information to a 
unique node address. If you want the characters representing the access information to 
be stored in uppercase letters, simply type the characters. If you do not want the char- 
acters to be stored as uppercase, place the string in quotation marks. For example: 


abc will be stored in the database as ABC 
‘‘Aab”’’ will be stored in the database as Aab 
Format 


SET ( NODE node-address NAME node-name |access info|[LAT—HOST] 
KNOWN NODES FROM node-id 
NODE node-id FROM node-id 


where 
NODE node-address specifies the address of the node to be defined. 


NAME node-name specifies the name to be associated with the node 
address. 


access info specifies access control information for the remote 
node in the following format: 


USER username [PASSWORD password] [ACCOUNT account] 
where 


username is a character string of 1 to 39 alphanu- 
meric characters that identifies the user at the remote 
node. 


password is a character string of 1 to 39 alphanu- 
meric characters that may be required to access files 
or programs on the remote node. 


account is a character string of 1 to 39 alphanumeric 
characters. 


See Sections 2.6 through 2.6.3 for more details on 
specifying access control information. 


LAT-—HOST indicates that the node is a LAT host. 
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KNOWN NODES FROM specifies a remote node from which to copy the com- 
fr node-id plete database of node names and node addresses to 
| } the local node. This set of node names will not 

include any access control information. 


NOTE 


If the database on the remote node is 
a large one (for example, in excess of 
100 nodes), this can significantly 
slow down the access time to the 


database. 
NODE node-id specifies a single node whose name and address are 
FROM node-id to be copied from the specified remote node into the 
local database. No access control information will be 
copied. 


Examples 
NCP>SET NODE 2.65 NAME MADRID USER MAGIC PASSWORD WAND(@ET) 


This command assigns the node name MADRID to the node at address 2.65. It also 
specifies the username as MAGIC and the password as WAND. 


NCP>SET NODE YODA FROM R2D2(RET) 


fn This command allows you to copy the node name YODA and its node address from the 
| specified remote node R2D2. 


er 
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2.9.23 SHOW CIRCUIT 


The SHOW CIRCUIT command displays all the information you set with the SET CIR- 
CUIT command, as well as certain system information. You can either display the 
information on your screen or redirect it to an output file at the local node. 


Format 


SHOW CIRCUIT [circuit-id] CHARACTERISTICS] [TO file-id] 
COUNTERS 
STATUS 
SUMMARY 


where 


CIRCUIT [circuit-id] specifies the circuit (either ASYNC-1 or ETHER-1) for which 
information is to be displayed. 


CHARACTERISTICS see definitions in Section 2.9.1. 
COUNTERS 

STATUS 

SUMMARY 

TO file-id 


Remarks 


Circuit counters monitor traffic and errors on individual circuits. The network coordi- 
nator periodically checks each circuit’s counters to assess circuit performance and 
determine potential problems. 


Examples 
NCP>SHOW CIRCUIT ASYNC-1 STATUS(@ET) 


This command displays the current status of circuit ASYNC-1. 
NCP>SHOW CIRCUIT COUNTERS(ET) 
This command displays the current counters for the circuit. 


NCP>SHOW CIRCUIT ETHER-1 STATUS TO CIR.DAT(RET) 


This command redirects the current status information about circuit ETHER-1 to an 
output file named CIR.DAT. (Since there is only one circuit to use for each configura- 
tion in both DECnet—DOS V1.0 and DECnet-DOS V1.1, the circuit-id is optional.) 
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‘ab, 


2.9.24 SHOW EXECUTOR 


The SHOW EXECUTOR command displays the executor node information. You can 
either display the information on your screen, or redirect it to an output file at the local 
node. 


Format 

SHOW EXECUTOR | CHARACTERISTICS [TO file-id| 
COUNTERS 
STATUS 
SUMMARY 

where 


CHARACTERISTICS see definitions in Section 2.9.1. 
COUNTERS 

STATUS 

SUMMARY 

TO file-id 

Examples 

NCP>SHOW EXECUTOR STATUS TO STAT .NODRET) 


This command redirects the status information for the executor node to an output file 
named STAT.NOD. 


NCP>SHOW EXECUTOR COUNTERS(RET) 


This command displays the counters for the executor node. 
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2.9.25 SHOW KNOWN ACCESS 


The SHOW KNOWN ACCESS command displays the contents of the incoming access \ } 
information database, which is stored in the file DECACC.DAT. If a password is part of 
the database entry, it only appears on the screen as three dots (...). 


Format 
SHOW KNOWN ACCESS 
Example 


The following example displays the incoming access information for the users BENCE, 
FOO, and MATAHARI. 


NCP>SHOW KNOWN ACCESS(RET) 


Access User/ 
Type Password 
RO BENCE/S.. . 
ALL FOO7... 
NONE MATAHARI 
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2.9.26 SHOW LAT 


f ) The SHOW LAT command displays information about the LAT line you may be using. 
The information may be directed to a file. This command only works if you have LAT 
installed on your node. 


Format 
SHOW LAT [COUNTERS] [TO /file-id] 
where 


COUNTERS see definitions in Section 2.9.1. 
TO file-id | 


Example 


The following command displays the counter information for the LAT line. 
NCP>SHOW LAT COUNTERS(RET) 
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2.9.27 SHOW LINE 


The SHOW LINE command displays line information. You can either display the infor- a 
mation on your screen or redirect it to an output file at the local node. 


Format 
SHOW LINE [line-id| [' CHARACTERISTICS ] [TO /file-id] 
COUNTERS 
STATUS 
SUMMARY 
where 
LINE line-id specifies either ASYNC-1 or ETHER-1 as the line for which 


information is to be displayed. 


CHARACTERISTICS see definitions in Section 2.9.1. 
COUNTERS 

STATUS 

SUMMARY 

TO file-id 


Remarks 


Line counters monitor procedures on individual lines. The network coordinator peri- 
odically checks each line’s counters to assess line performance and determine potential 


problems. a 


Example 
NCP>SHOW LINE ASYNC-1 COUNTERS TO STORE.LIN(RET) 


This command redirects counter information about line ASYNC-1 to an output file 
named STORE.LIN. 
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2.9.28 SHOW LINK 


( " ; The SHOW LINK command displays summary type information (see definition in Sec- 
| tion 2.9.1) for the specified logical links. 


Format 
SHOW (KNOWN LINKS 
ACTIVE LINKS 

where | 

KNOWN LINKS displays information for all logical links that are known to the | 
local node. 

ACTIVE LINKS displays information for all logical links that are known to the | 
local node. 

Examples 


NCP>SHOW KNOWN LINKS(RET) 


Known Link Status as of 06-Jan-1986 12:44:35 


State Socket Node Local Remote Local Remote 
Addr Addr # Name # Name 
Running 1 4.333 25824 34 O LLA25824 42 
Running 2 4.24 2585/ 17420 O LLA25847 42 
( ; Idle 3 4.333 25/762 25 O LLA25762 42 
| | Running 4 4.209 25891 2080 O LLA25891 42 


This example displays summary information (by default) for all logical links known to 
the local node. 


NCP>SHOW ACTIVE LINKS(RET) 


Active Links Status as of 06-Jan-1986 12:44:43 


State Socket Node Local Remote Local Remote 
Addr Addr # Name # Name 
Running 1 4.333 25824 34 O LLA25824 42 
Running 2 4.24 25857 17420 O LLA25857 42 
Running 3 4.209 25891 2080 O LLA25891 42 


This example displays summary information (by default) for all active logical links 
known to the local node. 


e 
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2.9.29 SHOW NODE 


The SHOW NODE command displays remote node information. You can either display 
the information on your screen, or redirect it to an output file at the local node. 


Format 
SHOW NODE node-id| STATUS |TO file-id| 
SUMMARY 
or 
SHOW ( KNOWN NODES 
ACTIVE NEEDS 
ADJACENT NODE 
where 
KNOWN NODES displays information for all nodes that you defined with the SET 
NODE command, in other words, nodes that are known to the 
local node. 
ACTIVE NODES displays information for all active nodes. Information is dis- 


played for the executor node, your adjacent node, and all nodes 
connected to the executor node by logical link(s). 


ADJACENT NODE displays information for the adjacent DDCMP node only. 


STATUS SUMMARY - see definitions in Section 2.9.1. Can be specified for SHOW Nea 
NODE node-id only; defaults to a summary display for other 
SHOW NODE commands. 


TO file-id see definition in Section 2.9.1. 


Examples 
NCP>SHOW NODE SOLO STATUS(RET) 


This command displays status information for node SOLO. 
NCP>SHOW ACTIVE NODES(RET) 


This command displays summary information (by default) for all nodes that are reach- 
able to your node. 


NCP>SHOW ADJACENT NODE TO ADJNOD.STA(RET) 


This command redirects summary information about the adjacent node to an output 
file named ADJNOD.STA. 


Oo 
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2.9.30 ZERO CIRCUIT 

The ZERO CIRCUIT command zeroes the counters for the circuit. 
Format 

ZERO CIRCUIT [circuit—id] [COUNTERS] 

where 


CIRCUIT [circuit-id| specifies either ASYNC-1 or ETHER-1 as the circuit for which 
counters are to be zeroed. 


Example 
NCP>ZERO CIRCUIT ETHER -1(RET) 


This command zeroes the counters for circuit ETHER-1. 
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2.9.31 ZERO EXECUTOR 


The ZERO EXECUTOR command zeroes the counters associated with and maintained 
on the executor node. 


Format 
ZERO EXECUTOR [COUNTERS] 


WZ 
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2.9.32 ZEROLAT 


e” The ZERO LAT command zeroes the counters for the LAT line. This command only 
works if you have LAT installed on your node. 


Format 
ZEROLAT [COUNTERS] 


Example 
NCP>ZERO LAT COUNTERS(RET) 


f* 
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2.9.33 ZERCLINE 
The ZERO LINE command zeroes the counters for the line. 
Format 


ZERO LINE [line-id] [COUNTERS] 


where 

LINE [line-id] specifies either ASYNC-1 or ETHER-1 as the line for which 
counters are to be zeroed. 

Example 


NCP>ZERO LINE ASYNC-1(RET) 


This command zeroes the counters for line ASYNC-1. 
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The Network File Transfer (NFT) utility is a network program that allows you to access 
remote files. After you install the DECnet—DOS software, you can use NFT to: 


Accessing Local and Remote Files 


Append two or more files. 

Copy files between the local and remote nodes. 
Delete local and remote files. 

List files located on a local or remote directory. 
Define and display access control information. 


Run batch (command) files on remote nodes. 


Display the contents of a local or remote file on your screen. 


Print files on remote printers. 


This chapter describes: 


Running NFT (see Section 3.1). 

Specifying access control information (see Section 3.2). 
File Specifications (see Section 3.3). 

Types of file systems (see Section 3.4). 

Typing NFT commands (see Section 3.5). 


Getting help (see section 3.6). 


File operations (see Section 3.7). 
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e The NFT commands and their syntax in alphabetical order (see Section 3.8). 


e How to provide remote file access to your node (see Section 3.9). 


e How to set up your computer to act as a server for multiple service functions (see 
Section 3.10). 


3.1 Running the NFT Utility 
You perform NFT functions by using one of the following methods: 


e Single command method: 


E>NFT command(RET) 
E> 


You can also use a batch file to start NFT. This command file can contain the NFT 
commands. For example: 


E>NFT <COMMANDS. DAT(RET) 
e = Multiple command method: 


E>NFT(RET) 

NFT>commandRET) 

NFT>commandRET) 

NFT>EXI 

E> 
You can also use to exit from NFT. To do this: 
1. Type the letter Z while you hold down the key. 
2. Press the key. 

NOTE 


When you run NFT in batch mode, an ERRORLEVEL of 0 is returned 
for success. A 1 is returned for failure. 


3.2 Defining Remote Node Access Information 


Access control information is security information that allows you to access a specified 
remote node with the privileges of a specific user. This information includes: 


e Username 


A character string consisting of 1 to 39 alphabetic characters that identifies the user 
at the remote node. 


e Password 


A character string consisting of 1 to 39 alphabetic characters. 
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e Account 
A character string consisting of 1 to 39 alphanumeric characters. 


You must follow the node name or node address (area.number) with the username, 
password and account enclosed in quotation marks (‘’). You must then follow the 
entire string with a double colon (::). The following is an example of a node name with 
access control information: 


LONDON “SMITH OPEN”’:: 


You can specify default access control information using NCP (see Chapter 2 of this 
guide), or you can specify the information directly to NFT during an NFT operation. 
When you specify the information during an NFT operation, NFT temporarily stores 
the information in a table for use in any following command dealing with the same 
node. 


The access control information you specify during an NFT session is not saved when 
you exit from NFT. Therefore, if you run NFT at another time, you cannot use any 
access control information previously specified in any NFT command. However, you 
can use any access control information you previously specified using NCP. If NCP pro- 
vides defaults and you specify your own values with NFT, the values you specify are 
used. 


3.2.1 Defining Access Control Information with NFT 

There are two ways to specify access control information during an NFT operation: 
e By accessing a remote node for the first time. 

e By using the SET command. 


NFT temporarily stores access control information for up to ten nodes. 


In the following example, you access a remote node by requesting a directory listing of 
files located on the VMS node LONDON, username SMITH, password OPEN. 


NFT>DIRECTORY LONDON"SMITH OPEN": : (RET) 


NFT displays the list of files located in the requested directory, including the block size 
of each file, and the time and date the file was last modified or created. 


Directory of: LONDON"SMITH password": :SYS$SYSROOT: [SMITH] 


PIlLEl. JATTe 12 O1-MAR-85 16701351 
Pilez. TAL; 34 02-SEP-83 14:20:35 
PILEo. (At js 22 O9-JUL-77 iZ:i5i%22 
NFT> 


NFT stores the access control information for node LONDON in its temporary table. 
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You use the SET command to specify and then save a username, password and account 
as well as specific disk and/or directory information. In the following example, you 
specify the username and password for node MADRID. In addition, you specify the 
name of the subdirectory ARENA.FILES. 


NFT>SET MADRID"ARENA BULL": : [ARENA. FILES ](RET) 


NFT stores the access information for node MADRID in its temporary table. 


3.2.2 Using Default Access Control Information 


Once you specify access control information using NFT, you can use the node name 
alone in subsequent file operations during the same NFT session. NFT uses the access 
control information you previously specified for the node name. This is the default 
access control information. 


For example, if you request a directory listing of node LONDON using only the node 
name, NFT displays the same list of files as the first time you accessed the node. When 
you type a node name alone, you must follow the name with a double colon. For exam- 


ple: 
NFT>DIRECTORY LONDON: : 


Directory of: LONDON"SMITH password": :SYS$SYSROOT: [SMITH] 


Pilel.TAr?t as O01-MAR-85 16:01551 
PiLe2.«cA1 fi 34 02-SEP-83 14520330 
FILES, FATS 4 22 O09-JUL-77 Le. dai 22 
NFT> 


When you type a node name alone, NFT follows this procedure to determine the access 
control information: 


1. First NFT checks to determine if you specified the access control information ear- 
lier in the same NFT session. If you did, that access control information is used. 


2. If you did not specify it earlier in the same session, NFT checks to determine if you 
specified it using NCP. If you did, that access control information is used. 


3. If you did not specify access control information either using NCP or earlier in the 
same NFT session, NFT assumes that the remote node does not require the informa- 
tion and attempts the current operation. (For information about access control, 
refer to Chapter 2.) 


3.2.3 Changing the Default Access Control Information 


You can change the default access control information by typing different access con- 
trol information for the same node name in an NFT operation. In this case, NET 
replaces the original access control information in its temporary table with the new 
information. 
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For example, if you request a directory listing of files on remote node LONDON, but 
specify a different username and password, NFT displays a list of files for the new user: 


NFT>DIRECTORY LONDON"DOC PEN": :(RET) 
Directory of: LONDON"DOC password": :SYS$SYSROOT : [DOC] 


ABG.TAT:1 10 07-SEP-84 12:10:49 
DEF .TXT;:1 29 12-—JAN-84 15720: 32 
GHI.TXT;1 Ay 03-—MAR-84 14:10:05 
NFT> 


Now if you request a directory listing using the node name alone, NFT displays this 
new list of files associated with node LONDON. 


NFT>DIRECTORY LONDON: : (RET) 


Directory of: LONDON"DOC password": :SYS$SYSROOT : [DOC] 


ABC .TXT;1 10 07-SEP-84 12:10:49 
DEF .1a) ca 29 12—JAN-84 LS: 20:32 
GHI.TXT;1 47 03-MAR-84 14:10:05 
NFT> 


You can also change the access control information using the SET command. In fact, 
when you use the SET command to specify default access control information, you can 
only replace the information in the NFT table using another SET command. For exam- 
ple, to change the access control information for node MADRID, type: 


NFT>SET MADRID"SPANISH DANCE": :(RET) 


Now if you request a directory listing using the node name alone, NFT displays the new 
list of files associated with node MADRID. 


NFT>DIRECTORY/BRIEF MADRID: :(RET) 
Directory of: MADRID"SPANISH password": :SYS$SYSROOT : [SPANISH ] 
LAW.DOC: 1 RULE . DOC: 2 


NFT> 


3.2.4 Displaying Access Control Information 


The SHOW command displays access control information that you specify during an 
NFT session. For example: 


NFT>SHOW(RET) 


LONDON"DOC password": : 
MADRID"SPANISH password": : 
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3.3 File Specifications 


A complete file name is called a file specification. A file specification provides the 
computer system with all the information it requires to identify a unique file. Each 
operating system in the network has its own set of rules for naming files. For example, 
when you name a local file, you must follow the standard DOS operating system for- 
mat: 


e Adrive name. (This is optional if you are using the default drive name.) 
e Apath name. (This is optional.) 
e =6A file name of up to eight alphanumeric characters. 


e A file type of up to three alphabetic characters, separated from the file name with a 
period. (This is optional.) 


The example below specifies a file named SURVEY.CRD. The file is located on drive A 
in the subdirectory SUE, which is located in the subdirectory USERS: 

A; \USERS\SUE\SURVEY .CRD 

When you access a file on a remote node, you must use a file specification that con- 


forms to the conventions required by the remote node. For example, some operating 
systems require a version number as part of the file specification: 


LONDON: :CHAP1.DOC; 2 


Example 3—1 shows how to copy a local DOS file called EMPLOY.LST to a remote VMS 
node named BATH. The file is stored on the remote node as NAMES.EMP;1 (Version 1). 


NFT>COPY A:EMPLOY.LST BATH** IRON BOATS'': :SCRB: [IRON]NAMES. EMP: 1(RET) 


Local DOS Node name Remote VMS file 
file with access specification 
specification control 

information 


Example 3-1: Copying a File to a Remote Node 


3.3.1 Specifying Remote Files 


DECnet-DOS can copy files to and from nodes running different operating systems. 
Refer to Table 3-1 for a list of file specifications that you can use with different operat- 
ing systems. 
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Table 3-1: Operating Systems and File Specifications 


Operating System 
VAX/VMS 
TOPS-20 
TOPS-10 

RSX 

P/OS 

DOS 

ULTRIX—32 


RSTS/E 


File Specification 
dev:[directory|filename.typ;ver 
dev:[directory]|filename.typ.ver 
dev:[directory]|filename.typ 
dev:[DIRECTORY ]filename.typ;ver 
dev:[DIRECTORY ]filename.typ;ver 
dev:dir\dir\..filename.typ 
dir/dir/.../filename.typ 


dev:[DIRECTORY ]filename.typ 


NOTE 


Most systems accept square brackets [ ] or angle brackets < > to 
delimit a directory name, and a period (.) or a semi-colon (;) to delimit 
version. NFT accepts all of these delimiters. 


If any portion of the above file specification formats is omitted, NFT assumes a default. 
File specifications of any other format are foreign to DECnet-DOS NFT. When you 
type a foreign file specification, you must enclose it in quotation marks (‘’). For exam- 


ple: 


NFT>COPY BOSTON: :"DK2:[100,100]NAMES. DAT”(RET) 
This directs NFT to copy the RSTS/E file from the remote node BOSTON to the local 


node, allowing unacceptable characters such as a comma in the directory name. 


Most file specifications are not foreign. 


3.3.2 Using Wildcards 


Wildcards allow you to specify more than one file at a time. There are three wildcards 


you can use: 


e A question mark (?) or a percent sign (%) matches any single character in the same 
position that the question mark or the percent sign occupies. For example, you can 
use TEST?.DOC to specify the following files: 


TEST1.DOC 
TEST2.DOC 
TESTA.DOC 
TESTB.DOC 
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¢ An asterisk (“) matches part or all of a file specification. For example, you can use 
*.DOC to specify the same list of TEST files. In this example, the asterisk replaces 
any file name with a file type of DOC. 


You can also use a combination of wildcards. For example, you can use TEST?.* to 
specify the following files: 


TEST 1,DOC 
TEST2.DOC 
TESTX.TXT 
TESTY. EXT 
TESTZ.TRY 


Note that some remote systems do not support all three wildcards. Also, there may be 
wildcards which are supported on some remote systems but not supported by NFT. 
3.3.3 Using Question Marks, Percent Signs, and Asterisks as Wildcards 


Local and remote files can contain question marks, percent signs, or asterisks as 
wildcards. NFT cannot change the names of the files when wildcards are used. As an 
example, you can type: 


COPY TEST?.* BOSTON: :*.* 


If you want to rename the files included in the remote file specification, you cannot use 
wildcards. For example, you cannot type: 


COPY TEST?.* BOSTON: :FOO?. « 


Wildcards can also be used with the DELETE, TYPE, and DIRECTORY commands. For 
example: 


DELETE LONDON: :*.*. * 


This command deletes all files in the user’s default directory on the node LONDON. 


3.4 Types of Files and Systems 
Files can be one of two data types: 
e IMAGE 


An image file is a file whose data is copied without any interpretation or data 
change. In other words, the file is copied and received as a carbon copy of itself. 
The most common example of this type of file is an executable file. 


e = =6 ASCII 


An ASCII file is a file whose records end with a carriage return/line feed (CR/LF) 
pair. 
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Systems can be one of two types: 


Stream 
With a stream system, a file is a series of continuous characters. 


Most stream systems including the DOS operating system do not support such attri- 
butes as fixed or variable length records. If a file with these attributes is copied to 
the local system, the attributes are lost. 


Nonstream 


With a nonstream system, file data is in specific record formats. For example, fixed 
length, stream, variable length, and variable with fixed length control (VEC). 


Fixed length records are all the same size. The size is fixed when you create the file, 
and you cannot change it. 


Variable length records can be of different lengths, up to a maximum size that you 
specify. The maximum size is fixed when you create the file, and you cannot 
change it. 


VEC records include a fixed length control field that precedes the variable length 
data. This format allows you to add data that labels the contents of the variable 
length portion of the record. 


Refer to Table 3—2 for the changes that occur when you copy a file from a remote node. 


Table 3-2: Copying Files from a Remote Node 


Data Type System Type Record Attributes How Stored 


IMAGE Not applicable Ignored As received from the 


remote node. 


ASCII Stream Ignored As received from the 


remote node with embed- 
ded carriage control. 


ASCII Nonstream Other than implied As received from the 
CR/LF, PRN or FIN remote node. 
ASCII Nonstream Implied CR/LF pair CR/LF added to each 
record. 
ASCII Nonstream PRN or FTN Data converted correctly. 


NFT converts embedded carriage control characters by default. You can cancel this 
conversion with the /NOCONVERT switch. 
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Although NFT can usually determine whether a file is ASCII, you should use the 
IMAGE switch when you copy a non-ASCII file to a remote node. Refer to Table 3-3 
for the changes that occur when you copy a file to a remote node. 


Table 3-3: Copying Files to a Remote Node 


Data Type System Type Record Attributes How Sent 

ASCII Stream None Unchanged. Records are 
determined by LFs. 

ASCII Nonstream Variable, Implied Carriage return/line feed 

CR/LF pair is dropped. Records 

are determined by LFs. 

IMAGE Stream None Unchanged. 

IMAGE Nonstream Fixed: 128 bytes Unchanged. 


3.5 Typing NFT Commands 


To type an NFT command, enter it at the NFT command prompt. The NFT commands 
consist of three parts: 


¢ The command verb and switch 
e The source file specification 
e The destination file specification 


A file specification may be local (no node name included) or remote (node name 
included). 


Example 3-2 defines the parts of an NFT command. 
NFT>COPY/PRINT FILE1.TXT LONDON: :FILE1. TXT: 1(RET) 


verb and source file destination file 
switch specification specification 
(local) 


Example 3-2: AnNFT Command 


Except for the node name and file specification (or the command verb and switch), you 
must separate one part of the command from another with a space or tab. 


You can abbreviate command verbs and switches to a character string that is unique to 
that verb. For example, you can type C for the COPY command, or /VA for the /VARI- 
ABLE switch. However, for clarity and consistency, all examples in this chapter show 
the full command syntax. 
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When using the key to continue a command on another line and a space is needed to 
separate the last word on the first line from the first word on the second line, you must 
enter the space immediately before or after the key. 


If you need help with a command or switch, remember to type the HELP command fol- 
lowed by an optional command name or switch. 


3.5.1 Command Prompts 


In many cases, if you type a command verb alone, the command prompts you for fur- 
ther information. For example, if you want to append one or more files to the end of an 
existing file and you type the APPEND command verb alone, APPEND prompts you for 
the required information as shown in the following example: 

NFT>APPEND@ET ) 

File(s)? LONDON’ ‘SMITH OPEN'': :WRIT: [SMITH]FILB. TXT; 3(RET) 


To? FILA. TXTRET) 
NFT> 


Command prompts are discussed in the applicable command descriptions. 


3.5.2 Command Switches 


Some operating systems store files with attributes that indicate the type of file and the 
format of the file’s records. A DOS file does not include attributes. Therefore, when 
you copy a file from the local system to another system that stores attributes (such as 
VAX/VMS), you can use switches to indicate the type of file you are copying and the 
type of system it is coming from. NFT provides defaults for file attributes. You can use 
switches to change these defaults. 


You can also use switches to modify command verbs. Switches are global in effect and 
must immediately follow the command verb in the command line. The same switch 
can have a different effect, depending on whether you are copying a file to or from a 
remote node. 


A valid switch for several NFT commands is /NOLOG. This switch requests that NFT 
not print a notification line after the APPEND, COPY, DELETE, PRINT, and SUBMIT 
operations. It is ignored for all other commands. 


If you use a valid switch that has no effect on certain commands, such as /NOLOG, NFT 
does not display a message. However, if you use a switch that NFT does not accept, 
such as /PRINT with a remote input file, NFT displays a message. 


Tables 3-4, 3-5, and 3-6 list valid NFT switches. 
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Table 3-4: Valid Switches for Copying Files from a Remote Node 


Switch 
/ASCII 


/IMAGE 


/BLOCK 


/NOCONVERT 


/NOLOG 
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Function 


No data interpretation is performed on ASCII file coming from a stream 
file system. For ASCII files being copied from a nonstream file system, 
data handling is determined by the remote file system and by the remote 
file’s record format and record attributes. This switch is valid only with 
the COPY and APPEND commands. 


Requests that NFT copy the file from the remote system as it is (binary 
data), with no conversion of any kind. This switch is valid only with the 
COPY and APPEND commands. 


NOTE 


If neither /ASCII nor /IMAGE is indicated, the infor- 
mation that was passed from the remote node will be 
used to copy the file. This is also the default. 


Copies files as image mode files, with no regard to record structure. 
This allows you to move files that have undefined formats or files with 
very long record lengths. When you indicate /BLOCK, it forces the fol- 
lowing attributes: /IMAGE mode, /FIXED length, and /MRS of 512. 


NOTE 


When you use this switch, do not include any other 
switches 


If the file is copied from a node with an RMS file system, and the record 
attributes for the file are either FTN (FORTRAN carriage control) or 
PRN (print file carriage control), the carriage control characters within 
each logical record are normally expanded before the record is written 
to the local file. This switch turns that feature off. (For details on 
/NOCONVERT, refer to the VAX-11 RMS Reference Manual or other 
appropriate system manuals.) This switch is valid only with the COPY 
and APPEND commands. 


Requests that NFT not print a notification line after the APPEND, 
COPY, DELETE, PRINT, and SUBMIT operations. 
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Table 3-5: Valid Switches for Copying Files to a Remote Node 


fr Switch 


/ASCII 


IMAGE 


/FIXED 


“ 


/VARIABLE 


/VFC=nnn 


/ALLOCATION = nnn 


Function 


Tells NFT that the file has records that end, by default, with a carriage 
return/line feed pair. This switch is valid only with the COPY and 
APPEND commands. If the first record does not end with a CR/LF pair, 
an image copy of the file is made. 


Requests that NFT copy the file to the remote system as it is, (binary 
data) with no conversion of any kind. The default record format is 
FIXED and the default Maximum Record Size (MRS) is 128 bytes. You 
can change these defaults with the /VARIABLE (or /VFC) and /MRS 
switches respectively. The last record can be shorter than the previous 
records. This switch is valid only with the COPY and APPEND com- 
mands. 


NOTE 


If neither /ASCII nor /IMAGE is indicated, the file is 
examined. If the first 512 bytes contain CR/LF, the 
file is copied as ASCII. If the first bytes do not contain 
CR/LF, the file is copied as an image file. 


Indicates that the records within the file are all the same length. By 
default, the length is 128 bytes, but you can change the length with the 
/MRS switch. This switch is valid only with the COPY command. 


If you are copying a file to an RMS file system, this switch resets the 
record format (RFM) to Variable length records, with a Maximum 
Record Size of 0 (no maximum). You can change the Maximum Record 
Size with the /MRS switch. This switch is valid only with the COPY 
command. 


If you are copying a file to an RMS file system, this switch sets the record 
format (RFM) to Variable length with fixed control headers of length 
nnn, where nnn = 0 to 255 bytes. The default header size is 2. The first 
n bytes become the header record. 


If you are copying the file to a stream system, this switch has no effect. 
NOTE 


If neither /FIXED nor /VFC is indicated, the default is 
/VARIABLE. 


If you are creating a new file on a remote system, this switch requests 
that the remote system set the allocation quantity (in blocks) for the 
new file to nnn. The default is 0, which causes allocation as needed. 
This switch is valid only with the COPY command. The valid range is 0 


to 2147483647. 
(continued on next page) 
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Table 3-5 (cont.): Valid Switches for Copying Files to a Remote Node 


Switch Function WY 


/BLOCK Copies files as image mode files, with no regard to record structure. 
This allows you to move files that have undefined formats or files with 
very long record lengths. When you indicate /BLOCK, it forces the fol- 
lowing attributes: IMAGE mode, FIXED length, and a MRS of 512. 


NOTE 


When you use this switch, do not include any other 
switches. 


© Oe og Sets record attributes for files you are copying to RMS file systems only. 
If you are copying files to a stream system, such as TOPS-20, the record 
attributes are ignored. xxx represents one of the following: 


None — No record attributes. 


FTN — Records contain FORTRAN carriage control. Records that con- 
tain FORTRAN carriage control are not native to DOS systems. For 
details on FTN, refer to the VAX-11 RMS Reference Manual or other 
appropriate system manuals. 


CR — (Default) Records have an implied carriage return/line feed. 


PRN —- Records contain a fixed header with print carriage control. This { 
is used with the /VFC switch. Records that contain print carriage con- Nal 
trol are not native to DOS systems. For details on PRN, refer to the 
VAX-—1I1 RMS Reference Manual or other appropriate system manuals. 


It is assumed that if you specify an explicit record attribute for the out- 
put file, the file data already conforms to that specification. In this case, 
NFT does no conversion. This switch is valid only with the COPY and 
APPEND commands. 


/DELETE Is valid only with the /PRINT switch. It requests that NFT delete the 
copied file from the remote node after the file is copied and printed. 
This switch is valid only with the COPY and APPEND commands. 


/LSA Indicates to a remote node that records are line sequenced ASCII. LSA 
files are valid for remote systems. They are not native to DOS systems. 
For details on LSA record attributes, refer to the appropriate TOPS-—10 
and TOPS-—20 DECnet documentation. 


/IMACY 11 Indicates that the file is to be written on the remote node in MACY11 
format. This switch is valid only with the APPEND and COPY com- 
mands. MACY11 files are only valid for remote systems. They are not 
native to DOS systems. For details on MACY11 record attributes, refer 
to the appropriate TOPS—10 and TOPS—20 DECnet documentation. 


(continued on next page) a 
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Table 3-5 (cont.): 


Switch 


/MRS = nnn 


/NOLOG 


/NOSPAN 


/PRINT 


/SUBMIT 


Valid Switches for Copying Files to a Remote Node 


Function 


Sets the Maximum Record Size, where the nnn is 0 to 32767. The 
default MRS for VARIABLE is 0. This means no maximum for VARIABLE 
file copies. The default MRS for FIXED files is 128. This switch is valid 
only with the COPY command. 


Requests that NFT not print a notification line after the APPEND, 
COPY, DELETE, PRINT, and SUBMIT operations. 


Requests that records not span blocks. It is valid for RMS file systems 
only. This switch is valid only with the COPY command. 


Allows you to print a file on the remote node’s default printer after the 
file copy is complete. This switch is valid only with the COPY and 
APPEND commands. 


Allows you to queue a batch file to be executed at the remote node after 
the file copy operation is complete. This switch is valid only with the 
COPY and APPEND commands. 


Table 3-6: Valid Switches for the DIRECTORY Command 


Switch Function 


/BRIEF Requests that NFT display file names only. The names are displayed on the 
screen four to a line. 


/FULL Requests that NFT display complete file information for one or more files. 
The information for each file includes: the file name; the file size (in blocks); 
the owner of the file; the date and time the file was last modified or created; 
the type of file organization, record format, and record attributes; and the 
type of protection assigned to the file. 
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3.6 Using the HELP Command 


If you need assistance in selecting NFT commands and switches, use the HELP com- 
mand. Type: 


NFT>HELP(RET) 
The system responds with: 


Help is available on the following commands: 


APPEND COPY DELETE DIRECTORY 
EXIT HELP PRINT SET 

SHOW SUBMIT TYPE 

switches: 

/ALLOCAT ION /ASCII /BLOCK /BRIEF 

7GG /DELETE /FIXED /FULL 

/ IMAGE /LSA /MACY11 £=/MRS 
/NOCONVERT /NOLOG /NOSPAN- /PRINT 

/ SUBMIT /VARIABLE /VFC 


To obtain information about the SHOW command, for example, type: 
NFT>HELP SHOWRET) 


To obtain information about the /ASCII switch, type: 
NFT>HELP /ASCI I(RET) 


3.7 File Operations 


NFT allows you to manipulate files on accessible DECnet nodes. Using NFT, you can 
perform file operations, such as: 


e Appending files. 

e = Listing files. 

e Copying files. 

e §6©Deleting files. 

e Displaying file names. 

® Printing files. 

e Typing the contents ofa file. 


e Submitting files as batch jobs. 


3-16 DECnet-DOS User’s Guide 


y 


3./.1 Appending Files 


To copy one or more files to the end of an existing file, use the APPEND command. You 
can append the following combination of files: 
e A locai file to a remote file. 


e¢ Aremote file to a local file. 


For example, to append the remote file FILB.TXT, located on the VAX node LONDON, 
to the local file FILA.TXT, type: 


NFT>APPEND LONDON"SMITH OPEN": :WRIT: [SMITH]FILB.TXT;3 FILA. TXT(RET) 
The two files are now: 


e The local file, FILA.TXT, which includes the contents of FILA.TXT and FILB.TXT. 


e The remote file, FILB.TXT;3, which is the original copy of FILB.TXT on node 
LONDON. 


If you are appending more than one file to the end of another file, separate the file spec- 
ifications with a comma. For example: 


NET>APPEND LONDON"SMITH OPEN": :WRIT: [SMITH]FILB.TXT;3,FILC.TXT;2 
FILA. TXT@ET) 


Remember to use the key to continue a command line. 


3.7.2 Listing Files 


For the APPEND, COPY, and TYPE commands, you can list up to ten file specifications. 
For example, you can append one to ten input files to a single output file. When you list 
files, the following rules apply: 

e You cannot list more than ten file specifications. 

e You cannot use wildcards (asterisk or question mark) in a list of files. 

e You must separate each item in the list by a comma. 


e These commands use temporary defaults when you enter a command line that con- 
tains more than one input file specification. Temporary defaults are used for: 


— Node name. 
— Device name. 
— Directory name. 


— File name and file type. 


If a file specification includes a device and/or directory name, these names are applied 
to subsequent file specifications within the list. For example: 


NFT>COPY BOSTON: :DBA1: [ADAMS]TEST1.DAT, 
TEST2.DAT , TEST3 . DAT(RET) 


This command copies three test files all from directory ADAMS on the device DBA1. 
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3.7.3 Copying Files 
To copy files between your node and a remote node, use the COPY command. 


When you copy a remote file to the local node, you must use the correct remote file 
specification. The following example copies a remote file named NEWS.DOC:10 from 
a VMS node called LONDON to the local node. The remote file is located in the direc- 
tory SMITH on device WRIT. The file is given the new name FLASH.DOC when it is 
copied to the local node. 


NFT>COPY LONDON"SMITH OPEN": :WRIT: [SMITH]NEWS.DOC: 10 FLASH . DOCQRET) 

You can also copy a file from a remote node to a local node without specifying a local 
file name. For example: 

NFT>COPY LONDON"SMITH OPEN": :WRIT: [SMITH]NEWS. DOC: 1 O(RET) 


By default, the local file is named NEWS.DOC, the same as the original file. 


When you copy a local file to a remote node, you must specify the local file name and 
the remote node name. You can also specify the remote file name in a format supported 
by the remote operating system. For example, to copy a DOS file called FILEA.TXT 
from drive B on the local node to directory SMITH on the LONDON node, type: 


NFT>COPY B:FILEA.TXT LONDON"SMITH OPEN": :WRIT: [SMITH] FILEA. TXT; 3Q@ET) 


By default, the remote file is FILEA.TXT, the same as the local file. 


3.7.4 Deleting Files 


To delete a file or a group of files, use the DELETE command. The following example 
deletes all versions of a file named TEST1.TST from a remote VAX node named 
GENEVA. 


NFT>DELETE GENEVA: : TEST1. TST: *(RETD 


If you only want to delete one file, enter the name and the type for the file. If there is 
only one version of that file on the remote node, NFT will delete it. If there are multiple 
versions of the same file, NFT will delete only the latest (or highest) version of the file. 


To delete a file which is not the latest version of that file, you must indicate the specific 
version number you want to delete. For example: 


NFT>DELETE RAMONA: : FINDER. TXT; 3(RET) 


This command deletes version 3 of the file FINDER.TXT on the remote node 
RAMONA. 
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3.7.5 Displaying Directory Information 


To display a list of local or remote file specifications on the screen, use the DIREC- 
TORY command. The names are displayed in the format used by the specified node. 
For example, to list file specifications from a directory on the remote VAX node LON- 
DON, type: 


NFT>DIRECTORY/BRIEF LONDON: :(RET) 
The system responds with: 
Directory of: LONDON"SMITH password": :SYS$SYSROOT: [SMITH] 


APNDXA . DOC ; 3 CHAP 1 . DOC; 2 CHAP2 .DOC; 13 DATA.DAT ;9 
NEWS . DOC; 10 MEMO. TXT; 1 TES (2.15156 TESTS. TSii2 
TEXT .DOC;8 


You can also list either a single file specification or use wildcards to specify a group of 
file specifications. The following example lists the group of files with a file type of TST: 


NFET>DIRECTORY/BRIEF LONDON: : *.TST(RET) 
Directory of: LONDON"SMITH password": :SYS$SYSROOT : [SMITH] 
TEST2.TST:6 TEST3.TST;2 


3.7.6 Printing Files 


To print a local file on a remote printer, use the /PRINT switch with the COPY or 
APPEND command. For example, to copy the FILEA.TXT from the local node to the 
remote node LONDON and then remotely print the file, type: 


NFT>COPY/PRINT FILEA.TXT LONDON: :FILEA. TXT; 1(RET) 


Be aware that you cannot print a remote file on the local printer using the /PRINT 
switch. If you try, the file is copied to the local node, and NFT displays the following 
warning message: 


Warning: Cannot print files on local printer. 


However, you can print a remote file on the local printer by copying it to the printer 
device. 


You can also print a remote file on a remote printer. To do this, use the PRINT com- 
mand. You must specify the name of a file that already exists on the remote node. For 
more information about PRINT, refer to Section 3.8.7. 


3.7.7 Typing a File’s Contents 


To display the contents of a file on your screen, use the TYPE command. For example: 
NFT>TYPE TEXAS: :PS:<SMITH>FILE1 .DOC; 2(RET) 
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3.7.8 Running Command Files 


A command or batch file contains a list of command strings. To execute the commands a 
within a remote command file on the remote node, use the NFT SUBMIT command fol- : 
lowed by the name of the remote command file. By typing commands in one batch file, 

you can run the file many times without retyping the commands. 


You can also use the /SUBMIT switch to execute commands in a local file on a remote 
node. This switch is only valid with the APPEND and COPY commands. When you use 
/SUBMIT with either of these commands, the copied file is queued to the remote node’s 
batch system (once the copy operation is complete). 


The following example is a batch file called DUMP.CTL.13 on the TOPS-20 remote 
node TEXAS. The batch file is located on the device PS: in the directory JONES. 


@PRINT PS:<SMITH>FILE1.DOC; 2 
@PRINT PS:<SMITH>.BAK 


This file: 

1. Prints the file called FILE1.DOC;2 located in the SMITH directory. 
2. Prints all files with a file type of .BAK in the same directory. 

To run this file, type: 

NFT>SUBMIT TEXAS: :PS:<JONES>DUMP.CTL. 13(RET) 


This file is placed in the batch queue on node TEXAS. You cannot run a local command | | 
file using SUBMIT. a 


3.7.9 Logging File Operations 


When you type an NFT copy command, such as COPY or APPEND, NFT displays a noti- 
fication that it has opened the specified files. In the following example, NFT logs the 
copy operation, and notifies you as it opens the specified files. 


NFT>COPY INTRO.DOC LONDON"SMITH OPEN": : (RET) 


NFT responds with: 


Copying file: INTRO.DOC to LONDON"SMITH OPEN": : INTRO.DOC;1[10 records] 
NFT> 


The notification line is displayed in two parts: 


e The first part includes all of the text up to the record count in brackets. It is dis- 
played as soon as both the remote and local files are successfully opened. 


e The second part is the record count [10 records] at the end of the line. This part is 
displayed when the copy operation is complete. 


You can suppress the logging message for the APPEND, COPY, DELETE, PRINT, and 
SUBMIT commands by using the /NOLOG switch. 
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3.8 NFT Command Summary 


NFT provides you with command verbs that allow you to manipulate files located on 
local and remote nodes. Table 3-7 lists each NFT command and its function. The 
remainder of the chapter discusses each command in alphabetical order. 


Table 3-7: Valid NFT Commands 


Command 


APPEND 


COPY 


DELETE 
DIRECTORY 
EXIT 


HELP 
PRINT 


SET 


SHOW 
SUBMIT 
TYPE 


Function 


Appends files from the local node to an existing file on the remote node, 
or copies and appends files from the remote node to an existing file on 
the local node. 


Copies files from the local node to the remote node or from the remote 
node to the local node. 


Deletes a local or remote file. 
Lists files located in a specified directory. 


Exits from an NFT operation and returns control to the DOS operating 
system. (You can also exit by typing (RET ).) 


Displays information about NFT commands and switches on the screen. 


Allows you to queue a file that exists on a remote node to be printed at 
that remote node. 


Allows you to set remote file access defaults for the current NFT ses- 
sion. 


Displays access control information for remote files. 
Submits a batch file to be run on a remote node. 


Displays the contents of a local or remote file on the screen. 
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3.8.1 APPEND 


The APPEND command adds the contents of one or more input files to the end of an 
existing output file. You can append either ASCII or binary files to or from remote 
nodes. 


Depending on its position in a command, a file specification is either input (source) or 
Output (destination). 


Format 
APPEND|/switch] input-file output-file 
or 


APPEND|/switch] 
File(s)? input-file 
To? output-file 


where 

/switch is a valid APPEND switch. The effect of a switch depends upon 
whether you are copying a file to or from a remote node. The valid 
APPEND switches are: 
/ASCII 
/DELETE 
/IMAGE 
/NOLOG 
/PRINT 
/SUBMIT 

input-file specifies one or more input files to be copied. If you specify multiple 
input files, you must insert a comma between the file specifications. 
NFT then appends the multiple files to the output file. 

output-file specifies the file to which the file(s) are to be appended. 

Remarks 


The local file specification has one of two forms. In its longest form, it consists of the 
drive name, directory path, file name, and file type. For example: 


A: USERS\SUE\SURVEY . CRD 


In its shortest form, it consists of the file name and file type. This form assumes that the 
file is in the current default DOS directory. For example: 


SURVEY . CRD 
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The remote file specification has one of two forms. In its longest form, it consists of 
node name and access control information followed by a file specification appropriate 
to the remote node. For example: 


LONDON" SMITH OPEN": :WRIT: [SMITH] FILEA.TXT;3 

In its shortest form, it consists of anode name followed by a file specification appropri- 
ate to the remote node, for example: 

LONDON: :FILEA.TXT;3 

If you append more than one input file to create a single output file, the attributes of the 
output file are determined by the attributes of the first input file that you specify in the 
command. If the attributes of the input files differ, the append operation seems to suc- 
ceed, but the output file may be incorrect. 

Example 

NFT>APPEND/PRINT FILE1.DAT ESTHER: :FILE2.DAT;1 


This command appends the local file FILE1.DAT to the remote file FILE2.DAT;1, 
located at node ESTHER. The resulting output file is printed. 


You can also use the /SUBMIT switch with this command. /SUBMIT causes the file you 
just created to be queued to the remote node’s batch system, once the append opera- 
tion is complete. 
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3.8.2 COPY 


The COPY command creates a new file or a new version of a file at the destination ) 
node. You can use the COPY command to copy files from the local node to the remote 
node, and from the remote node to the local node. 


Format 


COPY [Switch] input-file output-file 


or 

COPY [witch] 

File(s)? input-file 

To? output-file 

where 

/switch is a valid COPY switch. The effect of a switch depends on whether 


you are copying a file to or from a remote node. 
The valid switches when you are copying a file to a remote node are: 


/ALLOCATION = nnn 

/ASCII 

/BLOCK 

ICC = XXX 

/DELETE | 
/FIXED = nnn UW 
IMAGE 

/LSA 

/IMACY 11 

/MRS=nnn 

/NOLOG 

/INOSPAN 

/PRINT 

/SUBMIT 

/VARIABLE 

/VFC=nnn 


The valid switches when you are copying files from a remote node 
are: 


/ASCII 
/BLOCK 
IMAGE 
/INOCONVERT 
/NOLOG 


VY 
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input-file specifies the input file(s) to be copied. If you specify more than one 
input file, you must separate them by commas. 


output-file specifies the name(s) of the output file(s). 
Remarks 


The local file specification has one of two forms. In its longest form, it consists of the 
drive name, directory path, file name, and file type. For example: 


A: \USERS\SUE\SURVEY . CRD 


In its shortest form, it consists of the file name and file type. This form assumes that the 
file is in the current default DOS directory. For example: 


SURVEY .CRD 


The remote file specification has one of two forms. In its longest form, it consists of 
node name and access control information followed by a file specification appropriate 
to the remote node. For example: 


LONDON"SMITH OPEN": :WRIT: [SMITH]FILEA.TXT;3 


In its shortest form, it consists of anode name followed by a file specification appropri- 
ate to the remote node, for example: 


LONDON: :FILEA.TXT;3 
You can use the COPY command to: 


e Copy a single file. 
This operation copies a single file from one node to another. For example: 
E>COPY SAM.TXT LONDON: : SAM. TXT(RET) 

e Copy alist of files. 


This operation copies more than one input file to the same number of output files. 
NOTE 


If you specify multiple names, you must separate the file names by 
commas. There is a limit of 10 file names for each list. 
Remember that you cannot use wildcards when you use file name 
lists. 

For example: 

E>COPY LONDON: :SAM.TXT,SHAMI .TXT SAM.TXT,SHAMI.TXT(RET) 


¢ Copy multiple files using wildcards. 


This operation also copies more than one input file to the same number of output 
files. However, using this method, you can specify more than one file without typ- 
ing more than one file specification. For example, COPY *.SUM LONDON::*.SUM 
copies all files with a file type of SUM from the local node to node LONDON. The 
files are copied with the same file names and file types. 
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If you are copying a local file to a remote node, you can include the /PRINT switch or 
the /SUBMIT switch. These switches cause the file you just copied to be queued to the 
remote node’s printer or batch system, once the copy operation is complete. 


Use caution when copying files from operating systems allowing long file names, and 
nonalphanumeric characters. NFT truncates all file names to eight characters, and all 
file types to three characters. For example, NFT copies a remote file named 
THISISMY FILENAME.RIGHTHERE; 1 as THISISMY.RIG. 


Furthermore, the DOS operating system overwrites existing files of the same name. 
Therefore, if you copy a file called THISISMYOTHERFILENAME.RIGHTHERE; 1, NFT 
truncates it to THISISMY.RIG, and DOS overwrites the first file with the same name. 
This is also true when you are copying multiple versions of the same file. 


Examples 
NFT>COPY/PRINT/DELETE PAGE1.TXT LONDON: :PAGE1.TXT; 1(RET) 


This command copies the local file PAGE1.TXT to the remote node LONDON. The file 
is printed on the remote printer, and then deleted from the remote node. 


The output file specification can be omitted. In this case, the file specification is made 
the same as the input file specification. For example: 


NFT>COPY/PRINT/DELETE PAGE1.TXT LONDON: :(RET) 
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3.8.3 DELETE 

The DELETE command deletes one or more specified local or remote files. 
Format 

DELETE|[/NOLOG] file-spec 

or 


DELETE[/NOLOG] 
File(s)? file-spec 


where 
file-spec is any valid local or remote file specification. 


Examples 
NFT>DELETE LONDON: : TAX.LST; 3(RET) 


This command deletes the file TAX.LST;3 from the remote VMS node LONDON. 
NFT>DELETE ROME: : « .DOC; *(RET) 


This command deletes all versions of all files with a file type of DOC located on node 
ROME. 


You can only delete multiple files using wildcards. You cannot list files to delete them. 
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3.8.4 DIRECTORY 


The DIRECTORY command displays a list of local or remote file names, including the ‘ } 
size (in blocks) and the time and date the file was last modified or created. 


Format 


DIRECTORY |/switch] [file-spec] 


where 

/switch is either /BRIEF or /FULL. The default is no switch. 

file-spec is any valid local or remote file specification. If you omit the file speci- 
fication, NFT assumes the local disk and the current default directory. 

Examples 

Example 1. 


NFT>DIRECTORY LONDON: : TAX.LST:; 4(RET) 
Directory of: LONDON"SMITH password": :SYS$SYSROOT: [SMITH] 
TAX.LST;4 20 O9-JUL-85 12:30:52 


This command displays the file name TAX.LST;4 located on node LONDON. The dis- 
play includes the file’s size and the time and date the file was last modified or created. 


Example 2. 

NFT>DIRECTORY/FULL LONDON: : REPORT . DAT ; 4(RET) Neal 
Directory of: LONDON"SMITH password": :SYS$SYSROOT : [SMITH] 

REPORT . DAT ; 4 


Size: 8/9 Owner: [910,20] 
Created: 22-MAR-85 15:38:36 

File organization: Sequential 

Record Format: Variable length, maximum 128 bytes 

Record Attributes: Carriage return carriage control 

File protection: System: RWED, Owner:RWED, Group:RW, World:R 


This command displays complete information for the file REPORT.DAT on the remote 
node LONDON. The information includes the following: 


e =6 The size of the file (in blocks) 

e The owner (the specific user whose account contains this file) 
e §6The type of file organization 

e The type of record format used in the file 

e The type of record attributes contained in the file 


e The type of protection assigned to the file 
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All of this information is displayed when you use the /FULL switch for files on a remote 
node. If you request a DIR/FULL listing for a file on the local node, you will only see the 
size of the file and the time and date the file was last modified or created (see Example 
1, above). 

Example 3. 


NFT>DIRECTORY/BRIEF LONDON: :(RET) 


Directory of: LONDON"SMITH password": :SYS$SYSROOT : [SMIFH] 


APNDXA . DOC ; 3 CHAP 1 . DOC; 2 CHAPZ .DOC;13 DATA.DAT ;9 
NEWS .DOC; 10 MEMO. TXT; 1 TEST2. 13156 TESTS .TST j2 
TEXT .DOC;8 


This command lists all file names on the NODE LONDON. The list does not include 
sizes, times, or dates. If a file name consists of more that 19 characters, NFT truncates 
the name to 8 characters in the directory listing. 
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3.8.5 EXIT 


The EXIT command exits from an NFT operation and returns control to the DOS oper- ws 
ating system. 


Format 
EXIT 


Example 
NFT>EXITRET) 


This command exits you from the NFT utility. You can also enter and then (RET) 
to exit from NFT. 


3-30 DECnet-—DOS User’s Guide 


3.8.6 HELP 


oy The HELP command displays information about NFT commands and switches on your 
screen. 


Format 


HELP |command-verb 
/switch 


where 
command-verb is any valid NFT command verb. 
switch is any switch acceptable to NFT command verbs. 


Examples 
NFT>HELP(RET) 


This command displays a summary of all NFT commands. 
NFT>HELP SHOW RET) 


This command displays a summary of the SHOW command. 
NET>HELP /ASCII@ET) 


This command displays a summary of the effects of the /ASCII switch. 


or 
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3.8.7 PRINT 


The PRINT command queues a remote file to be printed on a remote printer. You must as 
indicate the file to be printed. The file will be printed on the system default printer. 


Format 


PRINT [witch] file-spec 


or 
PRINT |/switch] 
File(s)? file-spec 
where 
/switch is a valid PRINT switch. The valid PRINT switches for printing a file 
on a remote node are: 
/DELETE 
/NOLOG 
file-spec is any valid remote file specification. 
Examples 


NFT>PRINT LONDON: : TAX.LST; 3(@QET) 


This command queues the file TAX.LST;3 (located on the remote VMS node LONDON) 
to be printed on the default system printer (which is also located on node LONDON). WS 


NFT>PRINT ROME: :CHAPTER1 .MEM(RET) 


This command queues the file CHAPTER1.MEM on node ROME to be printed on 
ROME’s default system printer. Note that you cannot use wildcards or lists with the 
PRINT command. 


VY 
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3.8.8 SET 


The SET command allows you to set default access control information as well as disk 
and directory information for up to ten nodes. After you set this information, you can 
type the node name only, followed by two colons. NFT checks its default access con- 
trol information table for a record matching the specified node name. If it finds a 
match, NFT uses this information for network access. 


There are no valid switches for the SET command. 
Format 


SET node-spec::[file-spec| 


or 

SET 

Node? node-spec::[file-spec| 

where 

node-spec is a remote node name and access control information, followed by 
two colons. 

file-spec is the file specification string. It includes the disk and/or directory 
information for the remote node. It does not include the file name and 
version number. 

Examples 


NFT>SET LONDON"SMITH OPEN": :SYS$USER_DISK: [USER. FILES ](RET) 


This command sets default access control information for node LONDON. The infor- 
mation includes the disk that the file is on, SYS$USER__DISK, and the name of the 
subdirectory, USER.FILES. 


NFT>SET PARIS” JONES NEW": tiBED) 


This command sets default access control information for node PARIS. This informa- 
tion includes only the username JONES and the password NEW. 
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3.8.9 SHOW 


The SHOW command displays the temporary default table of remote access informa- 
tion for the specified node. The password is not displayed on the screen. Instead, the 
character string password is displayed in its place. 


There are no valid switches for the SHOW command. 
Format 
SHOW [node-name::] 


where 

node-name:: is a valid remote node name. If no node name is specified, NFT 
displays the contents of the access control information table for 
all nodes known to the NFT temporary default table. 

Remarks 


If NFT does not find the specified node name in the table, it checks to see if you typed 
default remote access control information using NCP. If you did, NFT displays the 
access control information. If NFT does not find the node name in its own table or with 
NCP, NFT displays: 


No defaults match: node-name: : 
Examples 
NFT>SHOW(RET ) 


This command displays the contents of the access control information table for all 
nodes known to the NFT temporary default table. This command does not display 
defaults you set using NCP. 


NFT>SHOW LONDON: : 


This command displays the access control information for node LONDON. 
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3.8.10 SUBMIT 


( ) The SUBMIT command requests that the specified command file be run on the remote 
node. The specified remote node must support command file submission and execu- 
tion. 


Format 


SUBMIT|[/NOLOG] remote-filespec 


or 

SUBMIT[/NOLOG] 

File(s)? remote-filespec 

where 

remote-filespec has two formats. In its longest form, it consists of node and 
access control information followed by a file specification 
required by the remote node. (See Section 3.2 for details on 
access control information.) In its shortest form, it consists of a 
node name followed by a file specification appropriate to the 
remote node, for example, NODE::FILE.TYP;3. 

Remarks 


Command files contain one or more commands that are recognized and run by the 
é \ remote node’s operating system. This means that the format of the commands within 
the file must conform to the standards of the remote system. 


Example 
NFT>SUBMIT PARIS: : BACKUP .COM(RET) 


This command requests that the file BACKUP.COM be run on the remote node PARIS. 
Note that you cannot use wildcards or lists with the SUBMIT command. 


ma 
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3.8.11 TYPE 


The TYPE command displays the contents of a local or remote file on your screen. You Vs 
should use this command for ASCII files only. 


Format 
TYPE /file-spec 
or 


TYPE 
File(s)? file-space 


where 
file-spec is any valid local or remote file specification. 


Example 
NFT>TYPE LONDON: : PREFACE . DOC(RET) 


This command displays the contents of the file PREFACE.DOC located on the remote 
node LONDON. 


y 
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3.9 Providing Remote File Access to Your Node Using FAL 


The File Access Listener (FAL) provides a way for you to let other nodes access files on 
your node. The purpose of the FAL utility is to listen for and receive remote access 
requests from the network. These requests are the results of file access routines from 
other nodes in the network (such as NFT on another pc node or a COPY command 
from a DECnet-—VAX system). When FAL detects a request to copy a file to or from your 
node, it first checks the type of access privilege contained in the request. If it has the 
proper privilege for access to your node, FAL sends or receives the file data to or from 
the requesting node. (Refer to Chapter 2 for details about specifying and displaying 
access information, using the NCP commands SET ACCESS and SHOW ACCESS.) 


FAL must be running on your system or must be run by the job spawner (see Section 
3.10) before any exchanges of file data can take place. To run FAL, type the command 
at the system prompt. For example: 


C>FAL(RET) 


The utility will run until you cancel it with or any other character. If you use 
(CTRUC), FAL will not finish the current task. Instead, it will exit immediately and close 
down all links with the remote node. If you use any other character, FAL will first finish 
its current task and then exit. 


While FAL is running, file data is passed back and forth between your node and the 
requesting node. You can control the way FAL operates by using switches. The valid 
switches for FAL include: 


/ASCII (/A) 
/BINARY (/B) 
/ERROR (/E) 
/LOG (/L) 


To use these switches, type them after the FAL command on the same line. There 
should be a space between the command and the switch. If you use more than one 
switch, be sure to separate them with a space. 


The following sections describe the FAL switches in more detail. 
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3.9.1 /ASCII 


MS-DOS systems do not retain file attributes with files. As a result, when FAL is asked \ ) 
by a remote node for the attributes of a file on the pc, it cannot determine what the 
attributes are. 


When you use the /ASCII switch, all files that are copied from the pc are transferred as 
ASCII files. An ASCII file is a file whose records end with end-of-text or line-terminat- 
ing characters, such as a carriage return/line feed CR/LF pair. 


If you use the /ASCII switch, FAL will copy all files in ASCII format, including image 
files. Note that image files can lose data if they are copied in the ASCII format. 


Format 
/ASCII 
Example 
C>FAL /ASCII(QET) 
NOTE 


If you specify neither the /ASCII nor the /BINARY switch, the default is 
CHECK. When FAL is started without either switch, it automatically 
checks each file it is requested to send. FAL looks for any CR/LF charac- 
ters in the first 512 bytes of the file. If there are any, it sends the file as 
ASCII. If the requested file is a binary file, FAL sends the file as binary. 


WY 


Yy 
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3.9.2 /BINARY 


c MS-DOS systems do not retain file attributes with files. As a result, when FAL is asked 
by a remote node for the attributes of a file on the pc, it cannot determine what the 
attributes are. 


When you use the /BINARY switch, all files that are copied from the pc are transferred 
as binary files. A BINARY (or image) file is a file whose data is copied exactly as it 
appears, with no interpretation of CR/LF characters. 


Using this switch ensures that any file copied to a remote node and then back to your pc 
will not lose any data. However, ASCII files copied from the pc when the /BINARY 
switch is used may not be in the proper format for use on the remote node. 


Format 
/BINARY 
Example 
E>FAL /BINARY(RET) 
NOTE 


If you specify neither the /ASCII nor the /BINARY switch, the default is 
CHECK. When FAL is started without either switch, it automatically 
checks each file it is requested to send. FAL looks for any CR/LF charac- 
ters in the first 512 bytes of the file. If there are, it sends the file as 
‘a. ASCII. If the requested file is a binary file, FAL sends the file as binary. 


(> 
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3.9.3 /ERROR 


When you use the /ERROR switch, FAL will report an error to the remote node if the VY 
requesting node is attempting to overwrite an existing file. If you do not set this switch, 

an existing file will be deleted and a new one will be created with the same name. The 

default is NO ERROR. 


Format 
/ERROR 


Example 
E>FAL /ERRORRET) 


“ » 
\ ) 
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3.9.4 /LOG 


When you use the /LOG switch, FAL logs the type of access for every request it 
receives. The type of access includes the following information: 


e the command or request (such as an NFT DIRECTORY or DELETE command) 
e the requested directory name and file name 

e the node name 

e the access control information for that node (username and account) 


This information is displayed on the screen in front of you. If you do not want to see 
the information on the screen, you can redirect it to an output file when you first issue 
the FAL command. 


Format 

/LOG: filename 

where 

filename is the name of a file to use for storing the access information. 


Example 
C>FAL /LOG:ACCESSINFO. TXT 


This command causes the logging information to be appended to the file 
ACCESSINFO.TXT. 
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3.10 Using Your Computer as a Server 


The Job Spawner is a DECnet—DOS utility that allows your computer to act as a server 
for performing multiple service functions. When you turn on the job spawner, it listens 
for any connect requests from other nodes in the network. When a connection arrives, 
the spawner starts the program which will service that request. When the service is 
complete, the spawner again waits for connections. In this way, your pc can process 
different requests at different times without any need for user intervention. 


In DECnet—DOS V1.1, the spawner supports both FAL and DTR. 


As an example, if the job spawner is running and it detects a request for file transfer, the 
spawner initiates the FAL utility and causes FAL to run. FAL will continue to run until 
the requested activity is complete. The spawner then continues to listen for other 
requests. (Two service programs cannot be run simultaneously.) 


To tell the spawner what program to run for each kind of connection that arrives, you 
must create the file DECSPAWN.DAT. You can use any editor that is installed on your 
system to create this file. It is an ASCII text file used as a database by the spawner. 


The format of DECSPAWN.DAT can be any number of the following lines: 
<object name ornumber> < program to run> 
A sample DECSPAWN.DAT which supports FAL and DTR would be: 


i? FAL 
63 DTR 


If you wish to write your own server programs, note the following: 
1. The server program is run by the spawner as if this command were typed: 
program —use n 


where v is the number of a socket accepted in deferred mode. The program must 
complete the connection. 


2. If a server program exits with a non-zero status, the spawner will detach the 
socket. If the program exits with a zero status, the socket should be detached by the 
server before exit. 


To start the job spawner, simply type SPAWNER at the system prompt and press (RET). 
To exit from the spawner, type an exclamation point (!). 


Format 
SPAWNER 
Remarks 


While you are running the job spawner utility, no other utilities should be running. 
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Examples 


The following example illustrates the spawner running and detecting a request for 
DTR: 


press to abort 

SPAWNER (V1.1.0) listening - Fri Feb 07 08:34:53 1986 

Fri Feb O7 08:35:11 1986 - Connect request from node 55.49 for object 
63 


Executing: dtr -use 2. 
[Appending messages to log file: E:dECNETdTR.LOG] 


DTR --I-- V1.1 (21-Jan-86) started on Fri Feb 07 1986 at 08:35:12 
DTR --I-- Connect reject test initiated on Fri Feb 07 1986 at 08:35:12 


DTR --I-- Terminated on Fri Feb 07 1986 at 08:35:13 

SPAWNER (V1.1.0) listening - Fri Feb 07 08:35:13 1986 

Fri Feb O7 08:35:23 1986 - Connect request from node 55.49 for object 
63 


Executing: dtr -use 2. 
[Appending messages to log file: E:dECNETdTR.LOG] 


OTR —-I=— V1.1 (21-Jan-86) started on Fri Feb 07 1986 at 08:35:23 
DTR --I-- Data echo test initiated on Fri Feb 07 1986 at 08:35:24 
DTR --I-- Data test complete on Fri Feb 07 1986 at 08:35:32 


DTR -—-—I-—— Terminated on Fri Feb O07 1986 at 08:35:32 

SPAWNER (V1.1.0) listening - Fri Feb 07 08:35:33 1986 

Fri Feb O7 08:35:44 1986 - Connect request from node 4.30 for object 
19 


Could not map object to image - rejecting connect 
SPAWNER (V1.1.0) listening - Fri Feb O07 08:35:44 1986 


SPAWNER exiting - Fri Feb 07 08:36:07 1986 

If the spawner cannot locate the necessary database to use for answering a request, the 
following information is displayed: 

Could not open file E:\DECNET\decspawn.dat 


Abort job spawner by pressing ‘'!'' 

Job spawner does not support multiple links. 

Database file for spawner in DECnet database path. 
Name of database file is DECSPAWN.DAT. 


Example contents of a DECSPAWN.DAT: 


TELL tel | 
TIMESRV timesrv 
SERVER server 
63 atr 
Zi receiver 
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Logging On to a Remote Host 


This chapter describes the SETHOST utility with network virtual terminal services. 
This utility connects your system to a host node and allows your system to act like 
(emulate) a terminal connected to the host node. 


When'your personal computer emulates a host terminal, you can perform many stan- 
dard terminal functions of that host and gain access to the host’s resources as if your 
personal computer was a terminal directly connected to the host node. 


Each time you log onto a host, the connection you make is called a session. Using 
SETHOST, you can create and maintain multiple sessions. The maximum number of 
sessions depends on the maximum number of network links you have established with 
the DEFINE EXECUTOR MAXIMUM LINKS command (see Chapter 2). The number of 
sessions also depends on the number of links that are currently active for the virtual 
disk or the virtual printer. 


There are two techniques for gaining access to a remote host system. Each technique 
has its own characteristics. The techniques are: 


1. LAT 


This technique provides access to LAT services. LAT is a local area transport proto- 
col that communicates over Ethernet. It is available for Ethernet configurations 
only. LAT supports TDMS applications, and can only be used for single sessions. 


2. CTERM 


CTERM is a wide area virtual terminal protocol which is layered on top of DECnet. 
It provides access to the entire DECnet network. It is available for both Ethernet 
and asynchronous DDCMP configurations. CTERM does not provide support for 
TDMS applications, but it does allow you to use multiple sessions. 


When SETHOST connects your node to another node, it checks to see if you have a LAT 
driver installed. If so, SETHOST first attempts to connect your node to a LAT line. This 
is the default. If LAT is not available, then SETHOST attempts to connect you using 
CTERM. You can select CTERM over LAT as the default by using the /CTERM switch. 


To use SETHOST, the host node must support terminal emulation from remote nodes 
and run Phase IV of the DECnet software on one of the following operating systems: 


e VAX/VMS, Version 4.0 or later 

e =RSX-11M-PLUS, Version 3.0 or later 
e RSX-11M, Version 4.2 or later 

e Micro—RSX, Version 3.0 or later 

e TOPS-10, Version 7.03 or later 

e TOPS-20, Version 6.1 or later 

e ULTRIX-32, Version 1.1 or later 


4.1 Using the SETHOST Command 


The SETHOST command, its parameters, and its various switches allow you to create, 
record, and modify your remote sessions. You can use the parameters and the switches 
in the command line, or you can use them at the S9ETHOST prompt. 


Format 
SETHOST [nodespec or latservicename}] [/switch] 


where 


nodespec specifies the DECnet node name or DECnet node number to use for 
establishing a remote CTERM session. 


latservicename specifies the LAT service name to use for establishing a remote LAT 


session. 

/switch is a valid SETHOST switch. The valid SETHOST switches are: 
/ABORT =n /LOG = filespec 
/CTERM /SAVEDEFAULT 
/EDIT = edit-mode /SESSION = session__number 
/EXIT /SSHOW 
/HELP = topic /TAKE = filespec 


The /EDIT, /SAVEDEFAULT, /SESSION and /SHOW switches are used 
with CTERM only. 


The following sections describe the SETHOST switches and parameters in more detail. 
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4.1.1 /ABORT 


The /ABORT switch lets you specify which session you want to abort. You can abort a 
single session or you can abort all the sessions. To view the current sessions, use the 
/SHOW switch. 


Format 


/ABORT =n 
ALL 


where 

n is the specific session number you want to abort. 

ALL indicates that you want to abort all of the current sessions. 
Remarks 


You can abort the current session, or you can abort a session that was saved previously. 
Note that if you abort the current session it will be deleted. Your link will be discon- 
nected and SETHOST will exit. 


Example 


The following example aborts session number 3, leaving all other sessions intact. 
SETHOST /ABORT=3(RET) 
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4.1.2 /CTERM 


The /CTERM switch lets you specify that CTERM protocol be used for the current con- 
nection. The default is to attempt to use LAT protocol first. If LAT is unavailable or if 
the LAT attempt fails, then CTERM protocol is used to complete the connection. Only 
CTERM provides support for multiple sessions. 


Format 
/CTERM 
Example 


The following example forces the connection to use CTERM protocol rather than LAT 
for establishing a session with the remote node THRUSH. 


SETHOST THRUSH /CTERM(RET) 
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4.1.3 /EDIT 


The /EDIT switch controls the type of command line editing you can perform during 
your remote session. This switch only applies to CTERM hosts or sessions that support 
command line editing. 


Format 
/EDIT = edit-mode 


where 
edit-mode is one of the three modes you can use for editing a command line. The 
three editing modes are: 
© OVERSTRIKE - causes the new character to replace a character at 
the current cursor position. 
e INSERT — causes the new character to be inserted to the left of the 
character at the current cursor position. 
e NONE - turns off command line editing. 
Remarks 


You can toggle between INSERT and OVERSTRIKE (within a single command line) by 
using (CTRUA). The default editing mode is reset at the beginning of each line. The 
default mode is OVERSTRIKE, unless you have changed it with a /EDIT switch (or if it is 
a saved default — refer to /SAVEDEFAULT for more information). 


Example 


The following example changes the editing mode to INSERT. 
SETHOST /EDIT=INSERT(RET) 
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4.1.4 /EXIT 


The /EXIT switch lets you exit from SETHOST. You can enter the switch after you have ' 
typed the SETHOST command. WwW 


Format 
/EXIT 
Example 


The following example illustrates first starting the utility, then requesting help for 
NODESPEC, and finally exiting from SETHOST. 


SETHOST(RET) 
SETHOST /HELP=NODESPEC(RET) 


SETHOST /EXIT(RET) 
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4.1.5 /HELP 


The /HELP switch displays the main help text screen for SETHOST. You can also get 
help on specific topics. 


Format 
/HELP = topic 
where 


topic 


Example 


is one of the specific SETHOST options for which you can view help 
text. The SETHOST help topics are: 


nodespec @ i (4 

/SESSION ITAKE /LOG /HELP /SAVEDEFAULT 
/SHOW /EDIT /ABORT /EXIT /CTERM 
keyboard-layouts context-switching 

syntax changing-default-line-editing-mode 


The following example displays help text for the syntax of SETHOST switches. 
SETHOST /HELP=syntax 
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4.1.6 latservicename or nodespec 


The latservicename parameter lets you specify the LAT service name to use for estab- 
lishing a remote session. The nodespec parameter lets you specify the DECnet node 
name or the DECnet node address to use for establishing a remote session. 


Format 
SETHOST nodespec or latservicename 


where 


nodespec specifies the node name or node address to use for the remote session. 
The nodespec can also include access information, such as the user’s 
password or account information. The format for the access informa- 
tion is [/USER/PASSWORD/ACCOUNT]. Note that this access control 
information is only used by ULTRIX hosts. 


latservicename specifies the LAT service name to use for the remote session. 
Remarks 
LAT service names are defined in two ways: 
1. They are accumulated over time by the LAT driver. 
2. They can be set using the following NCP command: 
NCP SET NODE address NAME name LAT 


If the LAT service name you specify with SETHOST is not yet known by the driver, or if 
you have not set it with the NCP SET command, the LAT connection can fail. 


Example 


The following example establishes a session on the node ROMAN, for the user 
WESTON and password KERNEL. 


SETHOST ROMAN/WESTON/KERNEL(RET) 
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4.1.7 /LOG 
The /LOG switch lets you record the terminal session in a log file. 
Format 


/LOG = filespec 


where 

filespec is the name of the file you want to use for recording your session. You 
can specify any file name with maximum of 8 characters for the name 
and 3 characters for the file extension. If you do not specify a name, 
the default file name is SESSION.LOG. 

Example 


The following example specifies SESSION4.LOG as the file to use for recording the ses- 
sion. 


SETHOST /LOG=SESSION4 . LOGRET) 
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4.1.8 /SAVEDEFAULT 


The /SAVEDEFAULT switch lets you save the switch settings to be used as the default 
for all future sessions. The /SAVEDEFAULT switch only works with the /EDIT and the 
/CTERM switches. If you use /SAVEDEFAULT and do not specify any switches to be 
saved, it has no effect. 


When you use this switch, SETHOST places your specified switch settings in a file 
called SETHOST.DEF in the DECnet directory. SETHOST reads this file whenever you 
start SETHOST. 


Format 
/SAVEDEFAULT /SWITCH [/EDIT] [/CTERM] 
Example 


The following example saves the default edit mode of INSERT in the SETHOST DEF 
file. 


SETHOST /EDIT=INSERT/SAVEDEFAULT(RET) 
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4.1.9 /SESSION 


The /SESSION switch specifies the session number to use for reconnection to a host. It 
only works if you are connected to the host using CTERM. 


You can use the /SHOW switch to determine which multiple sessions are available. You 
can then use /SESSION to reestablish a connection to a particular session. 


Format 

/SESSION =n 

where 

n is the number of the session to use for reconnecting to a host. 
Example 


The following example reconnects you to session number 2. 
SETHOST /SESSION=2(RET) 
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4.1.10 /SHOW 


The /SHOW switch displays a list of the current sessions and the hosts that connect as 
them to your node. The /SHOW switch only works if you are connected to the host 
using CTERM. 


Format 
/SHOW 
Example 


The following example displays 2 current sessions on hosts KL1026 and BOULET. 
SETHOST /SHOW(RET) 


Session Host 
1 KL1026 
2 BOULET 
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4.1.11 /TAKE 


( | ) The /TAKE switch sends text from a local file to the remote node as if it were typed at 
the remote node’s keyboard. 


Format 


/TAKE = filespec 


or 

@filespec 

where 

filespec is the name of the file containing the text you want to send to the 
remote node. If you use the /TAKE switch but you do not supply a file 
name, the default file name is SESSION.BAT. 

Example 


The following example requests that text be taken from the file SESSCOM.BAT and sent 
to node WINTER. You must include a space after the name of the remote node. 


SETHOST WINTER /TAKE=SESSCOM. BAT(RET) 


NOTE 
co Some remote systems or services may not be able to process more than 
one line of text correctly. 
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4.2 Interrupting a Session 


Whenever you interrupt a session by using (RET), the SETHOST menu is dis- 
played. The SETHOST menu lists various options for recording or changing your 
remote session. The following example illustrates a sample SETHOST menu. 

$ 

<Return> to exit SETHOST 

<H>elp 

<L>og session off 

<R>econnect to session 1 

<E>diting mode is overstrike 

<S>ession 

<A>bort session 

<N>ew session 


Command: 


The angle brackets indicate the key or letter you need to press to request one of the 
menu functions. Type only the first letter of the command you want to use. You do not 
need to press the key after you enter the letter. 


Note that the ‘Editing mode”’ option only applies to CTERM hosts or sessions that sup- 
port command line editing. 
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The following sections describe each of the menu options in more detail. 


4.2.1 <RETURN> 


The <RETURN> key lets you save the current session and exit from SETHOST. To 
return to the current session or reestablish a previous session, type SETHOST and the 
appropriate session number. For example: 


E:>SETHOST /session=2 


This happens only if you are using CTERM. If you are using LAT, the <RETURN> key 
disconnects you from the host and does not save the session. 


The previous example reconnects you to Session 2. (Note that logging off the remote 
host does not save the current session. You must use < RETURN > if you want to come 
back to the session at a later time.) If you want to review the established sessions, type 
SETHOST and press (RET). The system displays a listing of available session numbers, as 
well as the host system to which they are connected. 


4.2.2 <H>ELP 
HELP displays the help text for the SETHOST menu. 


4.2.3 <L>OG 


LOG lets you record your entire session as a file. When you type U, it acts as a toggle 
between ON and OFF. If the menu reads ‘‘Log session off’’ and you type ©), SETHOST 
changes logging to ON and prompts you for the filename to use for recording the ses- 
sion. When you redisplay the SETHOST menu, it should now indicate “‘Log session 
on’’ with the name of the file you indicated. 


If the menu reads ‘‘Log session on filename’’ and you type 0), SETHOST changes log- 
ging to OFF and closes the file it was using to record the session. When you redisplay 
the SETHOST menu, it should now indicate ‘“‘Log session off”’. 


4.2.4 <R>ECONNECT 


RECONNECT lets you leave the SETHOST menu and return to the current session. The 
current session number always displays on the menu. In the preceding menu example, 
the session number is 1. 


4.2.5 <E>DIT 


EDIT lets you change the default mode for command line editing. (This option only 
applies to CTERM hosts or sessions that support command line editing.) 


When you select this option, SETHOST displays a submenu with the following choices: 
e <O>verstrike 


e <I>nsert 
e <N>one 
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‘‘Overstrike’? mode means any letters you type replace the letters currently on the 
screen. ‘Insert’? mode means that letters are not replaced. Instead, they are inserted 
into the command line at the left of the cursor. ‘“None’’ means that no command line 
editing is available. 


4.2.6 <S>ESSION 


SESSION lets you connect to another session that you have previously saved. (This 
option only applies to CTERM hosts or systems that support multiple sessions.) 


When you select this option, SETHOST displays a list of the available sessions. You will 
be prompted for the session number you want to use. 


4.2.7: <A>BORT SESSION 


ABORT SESSION lets you abort a single session. You can abort the current session, or 
you can abort a session that you saved previously. When you select this option, 
SETHOST prompts you for the session number to be aborted. If you abort the current 
session (indicated by ‘‘“<R>econnect to session n’’), it will be deleted. Your link will 
be disconnected and SETHOST will exit. 


4.2.8 <N>EW SESSION 


NEW SESSION begins a new session. When you select this option, you are prompted 
for a node name or a LAT service name to use for Starting the next session. 


4.3 Your Rainbow 100 and IBM PC/XT or PC AT System as a VT102 
Terminal 


The Rainbow 100 computer systems support the keyboard functions performed by the 
VT102 class terminals. You should refer to the Rainbow documentation that describes 
VT102 terminal emulation. 


The IBM PC/XT and Personal Computer AT also provide VT 102 class terminal support 
but only during SETHOST sessions. To enter data on your IBM system as a VT 102 class 
terminal, different keys or combinations of keys may be required to simulate the 
VT102 class terminal key functions. Refer to documentation specific to your program 
or application for information on VT 102 class terminal emulation. 


When receiving data, the IBM PC/XT and PC AT personal computers and the VT102 
class terminals accept the same series of escape sequences. Refer to documentation on 
VT102 class terminals for more information. 


Figure 4—1 shows the layout of the Rainbow 100 system keyboard. The special keys dis- 
cussed in this chapter are highlighted on the illustration. 
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Figure 4—2 shows the layout of the IBM PC/XT system keyboard. The special keys dis- 


cussed in this chapter are highlighted on the illustration. 


paeoqhay waysks 1X/Dd WGI 


‘-b aunbi4 


DECnet-—DOS User’s Guide 


4-18 


Figure 4-3 shows the layout of the IBM PC AT system keyboard. The special keys dis- 


cussed in this chapter are highlighted on the illustration. 
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4.4 Using Your IBM System Keyboard during Terminal Emulation 


This section describes the IBM keys that can be used with SETHOST. For easy refer- 
ence, the functions are divided into four groups: 


° Letters, numbers and punctuation marks (main keyboard) 
e Function keys 

e Atrow keys 

e Numeric keypad 


Certain functions are implemented on the IBM system by holding down one of the fol- 
lowing special keys: the shift key (/\), the key, or the key while you depress 
another key. In text, this action is indicated by the notation and (_ALTix) 
where x represents the additional key. 


Some of the commands you issue with the special keys can also be implemented using 
either the Rainbow keys or certain function keys. Table 4-1 lists the commands, Rain- 
bow keys, and IBM function keys that are available when you emulate a VT102-class 
terminal ona VMS system. 
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Table 4-1: VMS Commands and Keys 


Rainbow IBM PC/XT IBM PC/AT 


Command Key Key Key Function 
Switches between overstrike 


mode and insert mode. The 
default mode (overstrike) is 
reset at the beginning of each 


line. 

I Recalls previously entered com- 
mands. 

— Moves the cursor one character 
to the left. 


Moves the cursor to the end of 
the line. 


CTRL/F -_ Moves the cursor one character 
to the right. 


CTRUH Fi2 | Moves the cursor to the begin- 
ning of the line. 


CTRL/J Deletes the word to the left of 
the cursor. 


CTRL/U Deletes characters from the 
beginning of the line to the cur- 
sor. 


OQ O e) 
“4 4 4 
BY) wy D 
= fe a L. 
mi w) oO 


CTR Deletes the word to the left of 
the cursor. 


: Allows you to re-examine a 
command you _ previously 
recalled using (CTRUB), Up- 
arrow, or F7. 


yy 
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Table 4-2 lists the commands, the Rainbow keys, and the IBM function keys that you 
can use when emulating a non-VMS system. 


Table 4-2: Commands and Keys for Systems Other than VMS 


Rainbow IBM PC/XT IBM PC/AT 


Command ‘Key Key Key Function 
Switches between  overstrike 


mode and insert mode. The 
default mode is reset at the 
beginning of each line. 


CTRL/U Deletes characters from _ the 
beginning of the line to the cur- 
sor. 

TRL/W Deletes the word to the left of 
the cursor. 
| None. Down-arrow _ escape 


sequence will be sent to the 
host, with no effect. 


sia Moves the cursor one character 
to the left. 
F10 F10 Moves the cursor one character 


to the right. 


I None. Up-arrow escape 
sequence will be sent to the 
host, with no effect. 


4.4.1. Letters, Numbers and Punctuation Marks 


Letters, numbers and punctuation marks on the IBM system are equivalent to the same 
symbols on the VT102 class terminals. However, some keys are in different positions 
on the keyboard. They function in the same way. 


4.4.2 Function Keys 


Certain key combinations are required for the IBM system to simulate VT 102 class ter- 
minal functions. They are: 


* ‘The key combination on the IBM system simulates the HOLD SCREEN key 
on the Rainbow. 


e The key combination on the IBM system simulates the SET-Up key on the 
Rainbow. This particular key combination enables you to enter and exit from the 
SET-Up display on your IBM system. 
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In addition, there are other sets of keys that function in the manner that you would 
expect when communicating with a host system. The specific keys, and how the IBM 
keys map to the Rainbow 100 keys appear in the following list. An illustration showing 
the location of the specific key(s) on each system appears immediately under the key 


pairs. 
Rainbow 100 Key 


ESC 
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IBM PC/XT Key IBM PC AT Key 

ESC 
ff a a 
es | f= = 
CTRL/J 


Fo Ie 


Too) 


LO oa 
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4.4.3. Arrow Keys 


The functions performed by the arrow keys on the Rainbow system and the application 
keys F7 through F10 on the IBM system will depend on your particular application. 
The specific keys, and how the IBM keys map to the Rainbow 100 keys appear in the 
following list. An illustration showing the location of the specific key on each systems 
appears immediately under the key pairs. 


Rainbow 100 Key 
I 
eee a Reed 


a 


Ps 
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4.4.4 Numeric Keypad 


Specific keys, located on the numeric keypad, perform functions that depend on the 
type of program running on your host. This dependency applies to both the Rainbow 
100 and the IBM personal computers. The combination key is used for some of 
the IBM functions. The particular keys (and how the IBM keys map to the Rainbow 100 
keys) are shown in the following list. An illustration showing the location of the spe- 
cific key(s) on both systems appears immediately under the key pairs. 


Rainbow 100 Key 
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IBM PC/XT Key IBM PC AT Key 
el oe 
b=") al 
(Scroll Lock ) 
es | 
(Sys Req ) 
b= hal 
- (dash) * (asterisk) 
3 AG 
(GHET=) - (dash) 
k= 3 1 
+ (plus) + (plus) 

== 
es 
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4.5 Setting VT102 Class Terminal Features Using SET-Up on the 
IBM PCs 


SET-Up allows your IBM system to emulate features of the VT 102 class terminal. Some 
of the features that you can set include: 


e Cursor style (block or underline) 
e Screen background (dark or light) 
e Automatic repeating of keyboard keys 


It is recommended that you do not change the settings for terminal features unless you 
are familiar with DECnet concepts. 


4.5.1 Entering SET-Up Mode 


Before you can enter SET-Up mode, a valid connection must be made to the remote sys- 
tem. To enter SET-Up mode, hold down the key while you depress the function 
key F3. The computer displays the first SET-Up screen — SET-Up Directory. SET-Up fea- 
tures are divided into 5 areas of common use called major headings. Each major head- 
ing includes specific parameters SET-Up menus. The major headings (shown as bolded 
text) and their SET-Up menus appear in the following list: 


Set-Up Directory 


Action 
Display 
General 
Screen 
EXit 


Action Set-Up 


Main Directory 
Clear Display 
Factory Parameters 
Save Parameters 
Recall Parameters 


Display Set-Up 


Main Directory 

No/Auto Wrap 

Dark Text, Light Screen/Light Text, Dark Screen 
No/Text Cursor 

Block Cursor Style/Underline Cursor 
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General Set-Up 


Main Directory 

VT52 Mode/VT 100 Mode 

Return = CR/Return = Cr/Lf 

Numeric Keypad/Application Keypad 
Normal Cursor Keys/Application Cursor Keys 


NOTE 


Numeric keypad causes the auxiliary keypad to transmit ASCII charac- 
ter codes corresponding to the numeric characters on the key. 


Application keypad causes the auxiliary keypad to transmit control 
codes used by an application program. 


Normal cursor keys transmit ANSI cursor control sequences (up, 
down, left and right). 


Application cursor Keys transmit application program control func- 
tions. 


Screen Set-Up 


Color enabled/black/white 
Screen foreground color 
Screen background color 
Pulldown foreground color 
Pulldown background color 


When using SET-Up menus, be sure the screen option of either “‘Color Enabled” or 
‘““Black/White’’ is set properly for the display adapter that is installed on your pc. 
4.5.2 Selecting a Parameter SET-Up Menu 


Use the arrow keys( fup, |! down, = left, and — right) to select a parameter 
SET-Up menu. The menu is displayed in reverse video. You can move to the specific 
parameter’s SET-Up menu by pressing the (plus) key. 


Use the appropriate arrow keys to move you to a particular parameter value. The value 
is displayed in reverse video. To change the value or perform the action, press the + 


(plus) key. 
For example, to select a block cursor style, use the following steps: 


1. Use the (ALTF3) key combination to enter the SET-Up Directory. 


2. Select the Display Set-Up parameter with the — (right-arrow). The parameter is 
displayed in reverse video. 


3. Press the + (plus) key to move to the Display SET-Up menu. 
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4. Use the appropriate arrow keys to move you to the block cursor style parameter. 
Press the + (plus) key to change this value. The selected value is displayed in 
reverse video. 


5. Use the key combination to exit from the SET-Up directory. 


4.5.3. Saving Set-Up Values 


To save the values you have selected in Set-Up mode, select the Save Parameters SET- 
UP menu from the Action SET-Up display. This action places the current parameters in 
the DECnet directory, in the file named VT102.DAT. By storing the parameters in the 
VT102.DAT file, SETHOST can restore saved parameters when it is run from any direc- 
tory. 

4.5.4 Using the Set-Up Values 


If you do not save parameters after changing them, the computer will use the new 
values until you: 


e Change the SET-Up features again. 
e Exit from SETHOST or turn off the computer. 


e Recall the original features by selecting the Factory Parameters from the Action 
SET-UP menu. 


e Run an application program that changes the features. 


4.5.5 Recalling the SET-Up Values 


If you have saved parameters, they are automatically read when you run the SETHOST 
utility. To recall the values you previously stored in the VT102.DAT file in the DECnet 
directory, select the Recall Parameters SET-Up menu. 


4.5.6 Exiting from SET-Up Mode 

To exit from SET-Up mode, hold down the @LDkey while you depress the function key 
F3. You can also use the Exit parameter from the SET-UP menu. 

4.5.7 Editing Text During a Remote Session 


You can edit text that is typed on the current line during a remote session by using one 
of the following procedures. and can be used as long as they are not 
required by the program you are running. The remote host may provide other special 
characters for editing text. 
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To edit text, use one of the following methods: 
e Press either the < X] or the back space key to delete the last character you typed. 


e Press this key to delete the last word you typed: 
e Press this key to delete the line you are typing: 


4.6 Disconnecting from a Host 


To disconnect from the host and break the logical link connection, use one of the fol- 
lowing methods: 


1. Log off using the standard log-off procedure established for that operating system. 
This procedure also exits you from the SETHOST utility. For example, to log off 
the VAX host, type: 


$ LOGOUT(RET) 


2. Use or (CTRU/4), then press the key. This exits from SETHOST, but 
allows you to save the session and retain a link to the host. If you then press the 
key, the session is deleted and the link to the host is disconnected. If you are abort- 
ing the current session (or if you only have one session established), you will also 
exit from SETHOST. 
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Using a Remote Printer and Disk 


The Network Device Utility (NDU) is a DECnet utility that controls your use of remote 
printers and disks as if they were directly connected to your personal computer. The 
disk or printer, resident on the remote node, appears to be a local device except for dif- 
ferences in access time. These differences depend on the type of communication ser- 
vices for the remote node you are using. 


A remote disk file can be assigned a volume name (such as G:) and can be used by MS-— 
DOS utilities or applications software as if it were a local hard disk volume. A remote 
printer is assigned the device name NPRN and can be used as if it were a local printer. 
Because the device only appears to be resident at the local node, it is called a virtual 
device. 


Using NDU, you can: 


e Assign a hard disk volume name to a new or existing remote file to be used as a vir- 
tual disk volume. 


e Stop the use of a remote file as a virtual disk volume. 
e Delete a remote disk file which had been used as a virtual disk volume. 
e Assign the printer device name NPRN to a disk file at a remote node. 


e Stop the use of the virtual printer at the remote node and ask that the saved text file 
be queued for printing. 


e Obtain status information about all assigned hard disk drives, printer devices, and 
command default values. 
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The NDU controls the use of both virtual disks and virtual printers: 
e =Virtual Disk Volumes 


NDU allows you to access up to four virtual disk volumes at a time. You can access 
four volumes on the same remote node, one volume on each of four different 
remote nodes, or any other combination totaling four volumes. Each remote vol- 
ume is a file that is treated as if it were a hard disk. The file is a binary file on the 
remote node which contains MS-DOS directories and files. 


e Virtual Printers 


NDU allows you to access one virtual printer at a time. The remote node which 
provides the virtual printer saves any text you output to the printer device NPRN in 
a temporary file. When you stop your use of the virtual printer, the temporary file 
is queued to be printed at the default printer on the remote node. 


This chapter is divided into two parts. 
Part I describes: 


e Installing the virtual device drivers (see Section 5.1). 

¢ Controlling virtual disk volumes (see Section 5.2). 

¢ Typing NDU commands to control virtual disk volumes (see Section pre} 
¢ Getting help (see section 5.4). 


e¢ An NDU command summary (see Section 5.5), followed by a description of each 
NDU command for virtual disks and its syntax in alphabetical order. 


Part II describes: 


¢ Controlling remote printers (see Section 5.6). 
¢ Typing NDU commands to control remote printers (see Section 37): 


¢ An NDU command summary (see Section 5.9), followed by a description of each 
NDU command for controlling remote printers and its syntax in alphabetical order. 


9.1 Installing the Virtual Device Drivers 


Although NDU controls your use of virtual devices, two other programs actually per- 
form the input and output for you. One program performs Operations for virtual disks, 
while the other performs operations for virtual printers. You must install these pro- 
grams (device drivers) on the DOS operating system before you can run NDU. If you do 
not, the following error message is displayed: 


Disk (or Printer) driver not installed 
You install the programs when you first install the DECnet—DOS software. The DECnet 
Installation Procedure (DIP) automatically installs the device drivers for you. Refer to 


the DECnet—DOS Installation Guide or the DECnet—Rainbow Installation Guide for 
more details. 
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5.2 Using NDU to Control Virtual Disks 


Using NDU you can create a disk file on a remote node to be used as a virtual disk vol- 
ume. 


You can create an unlimited number of virtual disks, but only four can be used at any 
one time. 


You enter the NDU utility by using one of the following methods: 


Method A: You enter a command string that includes NDU followed by the name of 
the specific NDU command. Press the (RET) key. 


E>NDU commandRET) 


After each NDU command is executed, the MS-DOS prompt is returned. 

E> 

This method can also be used for entering commands in batch mode. For instance, 
you may want to open virtual drives at startup time. To do this, include the NDU 


OPEN NODE node-name NDISK file-name DRIVE drive command in your 
AUTOEXEC.BAT file. 


Method B: You supply the name of the utility, NDU, and press the key. You 
cannot use this method for submitting NDU commands in batch mode. 

E>NDURET) 

NDU then responds with its own prompt. 

NDU> 


NOTE 


When you run NDU in batch mode, an ERRORLEVEL of 0 is 
returned for success. A 1 is returned for failure. 


Enter the NDU command after the NDU prompt, and press the key. Continue 
this procedure until you have entered all NDU commands. 

NDU>command(RET) 

NDU>command(RET) 

NDU> command(RET) 

To exit from NDU, enter the EXIT command and press the key. The system 
returns with the MS-DOS prompt. 


You can also use to exit from NDU. While holding down the (CTRL) key, 
press the letter Z key. Then press the key. 


NDU>EX I T(RET) 
ES 
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5.3 Typing NDU Commands 


Figure 5—1 shows an example of the parts of an NDU command: 


NDU>CLOSE DRIVE G(RET) 
verb value 
entity 


Figure 5-1: AnNDU Command 
NDU commands contain a verb which specifies the action to perform and entities with 


values which describe the specifics of that action. 


5.3.1 Command Verbs 


You can abbreviate command verbs to a character string that is unique to that verb. For 
example, you can type CRE for CREATE. However, for clarity and consistency, all 
examples in this chapter show the full command format. 


5.3.2 Entities 


Table 5-1 lists the entities that NDU commands act upon when controlling virtual 
disks. When you specify more than one entity in a command line, use either a space ora 
tab to separate them. 


Table 5-1: NDU Command Entities for Virtual Disks 


Entity Function 
ACCESS is used with the OPEN and CREATE commands to select the operat- 
access__mode ing mode used to access the virtual hard disk. RW access indicates 


that the disk can be read from or written to, but it cannot be shared. 
RO access indicates that the disk can be shared, but only for the pur- 
pose of reading. 


ALLOCATION n specifies the initial disk file size of the virtual disk file (in blocks) on 
the remote node. The value of 1 is a decimal number. This entity is 
only valid with the CREATE command. 


DRIVE drive specifies a drive name to be treated as a hard disk. The name is one 
alphabetic character. The drive name must be one of the names 
listed by the SHOW STATUS command. 


When you start NDU, it displays the drives that are available by indi- 
cating they are CLOSED. You can then select G, for example, as the 
drive name to be used in the DOS commands and functions that 
address a drive. 


MAX n is the maximum size of the virtual disk in megabytes. The value of n 
can be 1, 10, 20, or 32. Note that 32 megabyte disks made under MS-— 
DOS Version 2 are not compatible with 32 megabyte disks made 
under Version 3. 
(continued on next page) 
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Table 5-1 (cont.): 


Entity 
NDISK /file-name 


NODE node-name 
or 
node-address 


USER access-info 


NDU Command Entities for Virtual Disks 


Function 


identifies the file name associated with a drive name. For example, 
NDISK MYDISK1.DSK associates the file name MYDISK1.DSK with 
the drive name that is addressed by a DOS command. The file name 
can be from 1 to 126 alphanumeric characters in length. The file 
name may include device and directory fields, but they must be in 
the proper format for the remote node's system type. 


identifies and locates the virtual hard disk’s resident node. The node 
name can be from | to 6 alphanumeric characters in length and must 
contain at least one alphabetic character. 


You can also specify a node address for the remote node. The node’s 
address includes a unique area number and a node number, sepa- 
rated by a period: 


area.number 

where 

area is anumber in the range of 1 to 63. 
number can be in the range of 1 to 1023. 


specifies access control information for a specific remote node. This 
is the identification information that you enter during log on at the 
hard disk’s resident DECnet node. Each item in the identification 
string must be between | to 39 alphanumeric characters. 


The access control string has the following format: 
USER user-name |[/password|/account| | 
where 


user-name is the name of the user on the specified remote node. If 
USER is not specified, the default access control information set by 
NCP will be used. 


password is the password you need to access files or programs on 
the specified remote node. 


account is normally not required by operating systems. 


Note that account information cannot be supplied unless you supply 
a specific password as well. 
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5.4 Using the HELP Command 


If you need assistance in selecting NDU commands, use the HELP command. Enter the 
HELP command, then press (RET). For example: 


NDU>HELP(RET) 


To obtain information about one of the subjects listed, enter HELP again plus a subject. 
Then press (RET). For example: . 


NDU>HELP SHOWRET) 


5.5 NDU Command Summary for Virtual Disks 


NDU provides you with command verbs that allow you to control the use of remote 
files as virtual disk volumes. Table 5—2 lists each NDU command and its function. The 
remainder of this section discusses each command in alphabetical order. 


Table 5-2: 


Command 
CLOSE 
CREATE 


DELETE 
HELP 


OPEN 
SHOW 
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NDU Commands for Virtual Disks 


Function 
Requests that an existing connection to a virtual hard disk be terminated. 


Instructs NDU to create and open a new remote file and format it to be treated 
as a virtual hard disk. 


Deletes a remote file which had been used as a virtual hard disk. 


Displays a message explaining the use of the NDU command and the meaning 
of the command parameters. 


Requests a connection to an existing hard disk. 


Displays the activity and current state of the virtual hard disk(s) and virtual 
printer. A status report is also displayed at the completion of other function 
requests. 
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5.5.1 CLOSE 


Cy The CLOSE command ends the connection between the specified drive and the virtual 
<9 disk file on the remote node. 


Format 
CLOSE DRIVE drive 
or 


CLOSE NODE node-name NDISK file-name 


where 

drive is one alphabetic character that specifies the virtual drive to be acted 
upon. 

node-name identifies and locates the virtual hard disk’s resident node. The node 
name must be from 1 to 6 alphanumeric characters, including at least 
1 alphabetic character. 
You can also specify a node-address for the remote node. Refer to 
Table 5—1 to see how the node address is formatted. 

file-name specifies the name of the file that is the virtual disk on the remote 
node. The file name can consist of 1 to 126 alphanumeric characters. 
It may include device and directory fields, provided it is properly for- 

( ) matted for the remote node’s system type. 
Example 


NDU>CLOSE DRIVE G(RET) 


This command ends the connection between the local node and the remote hard disk 
drive G. Any subsequent operations to drive G result in the following error message: 


Not ready error reading drive G 
Abort, Retry, Ignore? 


“ey 
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5.5.2 CREATE 


The CREATE command creates and formats a new remote data file, which is treated as a | 
hard disk, and establishes a connection between a volume name at your local node and a 
the file. 


Format 
CREATE NODE node-name NDISK /file-name DRIVE drive 
USER access-info 
ACACHSS (2 
RO 
ALLOCATION n 
MAX n 
where 
node-name identifies and locates the virtual hard disk’s resident node. 
file-name | identifies the file name associated with a drive name. 
drive specifies the name for a drive to be treated as a hard disk. The 
name consists of one alphabetic character. You should use the 
NDU SHOW command to list available names for the disk. Only 
the names for closed drives can be used. The default is the next 
available drive. 
access-info indicates access control information for a specific remote node. ( _ j 
(See the entry under USER in Table 5-1 for a description of 
access control information.) 
RW or RO identifies the operating mode for accessing the virtual disk. RO 


specifies that the disk can be shared, but only for the purpose of 
reading. RW specifies that the disk can be read from or written 
to, but it cannot be shared. The default is RW. 


ALLOCATION n specifies the initial disk file size in blocks of the virtual disk file 
on the remote node. The value of 1 is a decimal number greater 
than the minimum virtual disk size. The default is the minimum 
SiZe. 


MAX n specifies the maximum size to which the virtual disk can grow 
in megabytes. The value of 1 in this case may be 1, 10, 20, or 32. 
The default value is 32. Note that a 32 Mbyte hard disk created 
under Version 2 of the MS—DOS operating system is not com- 
patible with a 32 Mbyte disk created under MS-DOS Version 
a0. 
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Remarks 


The following message is displayed while NDU is creating a new virtual hard disk file. It 
is an informational message only. The number of blocks displayed on the screen 
changes as the file is being created. 


CREATE DISK Writing Block n 


Following a CREATE request, NDU displays status information about the hard disk. 
The information is followed by the NDU> prompt. 


As you write files to a virtual disk, free space in the current file is used first. The file is 
then extended as necessary until the maximum size is reached. Deleting files from the 
virtual disk will NOT reduce the size of the virtual disk file. To reduce the size of a vir- 
tual disk file from which MS-DOS files have been deleted, you must create a new vir- 
tual disk and copy all files from the old disk to the new disk. 


Example 
NDU>CREATE DRIVE G NODE DUBLIN NDISK ACCTDEPT.TXT USER JONES(RET) 


This command creates a new remote file named ACCTDEPT.TXT to be treated as a vir- 
tual hard disk, drive G. Future access to this hard disk may be restricted to USER JONES, 
depending on the specified access control information. 


If DRIVE G already existed and was open, the following error message would be dis- 
played: 


Drive "G" is already OPEN: CREATE function not done. 
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5.5.3 DELETE 


The DELETE command deletes an existing virtual disk file on a remote node. 


Format 


DELETE NODE node-name NDISK /file-name [USER access-info] 


or 


DELETE DRIVE drive 


where 
node-name 
file-name 


access-info 


drive 


Remarks 


identifies and locates the virtual hard disk’s resident node. 
identifies the hard disk’s file name. 


indicates access control information for a specific remote node. If the 
access control information is omitted, the access data specified with 
NCP is used instead. (See the entry under USER in Table 5-1 for a 
description of access control information.) 


is one alphabetic character that specifies the virtual drive to be acted 
upon. 


After a DELETE request, NDU displays status information about all the drives. The 
information is followed by the NDU> prompt. 


Example 


NDU>DELETE NODE MUNICH NDISK TEMPDISK.TXT(RET) 


This command deletes a file named TEMPDISK.TXT, at node MUNICH. If a drive was 
opened with the specified virtual disk, this command closes the drive. The drive is now 
available for use with another virtual disk. 
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5.5.4 HELP 
The HELP command displays information about NDU commands and entities. 
Format 


HELP | command-verb 
entity 


where 
command-verb is the NDU command for which you want information. 
entity is the NDU entity for which you want information. 


Examples 
NDU>HELP(RET) 


The system displays a list of all NDU commands and entities for which help informa- 
tion is available. 


OPEN CLOSE DELETE CREATE SHOW EXiT MeLP 
NODE USER DRIVE NDISK NPRINT MAX ALLOCATION ACCESS 


NDUSHELP CREATE@ET) 


The system displays help information for the CREATE command. 
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5.5.5 OPEN 


The OPEN command establishes a connection between your local node and an existing } 
virtual hard disk at a remote DECnet node. . 


Format 


OPEN NODE node-name NDISK /ile-name DRIVE drive 
USER access-info 


ACCESS (R 
RO 


where 

node-name identifies and locates the virtual hard disk’s resident node. 

file-name identifies the file name associated with a drive name. 

drive refers to a drive name to be treated as a hard disk. The default is the 
next free drive. 

access-info indicates access control information for a specific remote node. If the 
access control information is omitted, the access data specified with 
NCP is used instead. (See the entry under USER in Table 5-1 for a 
description of access control information.) 

RW or RO identifies the operating mode for accessing the virtual disk. RO 
specifies that the disk can be shared, but only for the purpose of read- 
ing. RW specifies that the disk can be read from or written to, but it — 
cannot be shared. The default is RW. 

Remarks 


Following an OPEN request, NDU displays status information about the hard disk fol- 
lowed by the NDU> prompt. 


Example 
NDU>OPEN DRIVE G NODE DUBLIN NDISK ACCTDEPT.TXT(RET) 


This command opens a connection between the local node and the remote DECnet 
node DUBLIN. At that node, an existing file named ACCTDEPT.TXT is opened for 
READ WRITE access. All subsequent operations directed to the hard disk drive G are 
sent to ACCTDEPT.TXT at node DUBLIN. If the file does not exist, the OPEN operation 
fails and the following error message is displayed: 


OPEN function failed: the remote server could not find that file. 


If the file was already open, the following error message is displayed: 


Drive name is already open, cannot OPEN it again. 
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5.5.6 SHOW 


The SHOW command causes NDU to report on the status of all virtual disk(s) and 
printer. 


Format 
SHOW STATUS 
Remarks 


You can display system status information through the use of DOS commands such as 
DIR and CHKDSK. 


Examples 
NDU>SHOW STATUS(RET) 


Sample output from this command appears as follows: 


Disk Status/ Access Node/ Socket Reads Writes 

Drive Ndisk User 

E CLOSED 

F OPEN RW DUBLIN 6 241 68 
NDO1.NVD JONES/PASSWORD 

G CLOSED 

H CLOSED 

Printer Status/ Node Socket/ Writes 

Device Nprint User 

NPRN CLOSED 


This display includes the following information: 

e The name of the disk drive. 

e The drive’s status - OPEN or CLOSED. 

e The file name. 

e The ACCESS mode - read or write. 

e The NODE name, the USER name, and any account information. 


e The number of the SOCKET you are connected to. (DECnet assigns you to a 
socket). 


e The number of completed READ operations. 
e The number of completed WRITE operations. 
e The name of the printer. 

e The printer’s status -OPEN or CLOSED. 


The USER and account information are displayed if you have specified them in the 
CREATE or the OPEN command. If you do not specify this information and it is 
obtained from the NCP database, it is not displayed. 
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5.6 Using the NDU to Control Remote Printers 


The NDU utility allows you to direct text to a remote node to be queued later for print- 
ing. You enter the NDU utility by using one of the following methods: 


e Method A: You enter a command string that includes NDU followed by the name of 
the specific NDU command. Press the key. 


E>NDU command(RET) 
After each NDU command is executed, the MS-DOS prompt is returned. 
> 


This method can also be used for entering commands in batch mode. 


e Method B: You supply the name of the utility, NDU, and press the QET) key. You 
cannot use this method for submitting NDU commands in batch mode. 


E>NDU(RET) 
NDU then responds with its own prompt. 
NDU> 


Enter the NDU command after the NDU prompt, and press the key. Continue 
this procedure until you have entered all NDU commands. 


NDU>command(RET) 
NDU>command(RET) 
NDU>command(RET) 


To exit from NDU, enter the EXIT command and press the key. The system 
returns with the MS—DOS prompt. 


You can also use to exit from NDU. While holding down the key, 
press the letter Z key. Then press the key. 


NDU>EX I T(RET) 
E> 


NOTE 


When you run NDU in batch mode, an ERRORLEVEL of 0 is returned 
for success. A 1 is returned for failure. 


5.7 Typing NDU Commands 


Figure 5—2 shows an example of the parts of an NDU command: 
NDU>OPEN PRINTER NODE LONDON NPRINT fi |! e—name(RET) 


verb entities value 


Figure 5-2: AnNDU Command 
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NDU commands act on entities and their values. When using an NDU command, you 
must provide the command verb, the entity, and the entity value. 


5.7.1 Command Verbs 


You can abbreviate command verbs to a character string that is unique to that verb. For 
example, you can type CRE for CREATE. However, for clarity and consistency, all 
examples in this chapter show the full command format. 


5.7.2 Entities 


Table 5—3 lists the entities that NDU commands act upon when controlling remote 
printers. When you specify more than one entity in a command line, use either a space 
or a tab to separate them. 


Table 5-3: NDU Command Entities for Remote Printers 


Entity Function 


NODE node-name identifies and locates the printer’s resident node. The node 
. name can be from 1 to 6 alphanumeric characters in length and 
must contain at least one alphabetic character. 


NPRINT file-name specifies the name of the file which will contain the text, sent 
to the virtual printer, before it is queued for printing on the 
remote node. The file name can consist of 1 to 126 alphabetic 
characters. It may also include device and directory fields, but 
the name must be in the proper format for the remote node’s 
system type. 


USER access-info specifies access control information for a specific remote 
node. This is the identification information required to access 
the print file on the remote node. Each item entered must be 
between 1 and 39 alphanumeric characters. 


The access control string has the following format: 
USER user-name |/password|/account} | 
where 


user-name is the name of the user on the specified remote 
node. If USER is not specified, default access control informa- 
tion set by NCP will be used. 


password is the password you need to access files or programs 
on the specified node. 


account is a 1 to 39 alphanumeric character string that consists 
of account information. 


Note that account information cannot be supplied unless you 
supply a specific password as well. 
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5.8 Using the HELP Command 


If you need assistance in selecting NDU commands, use the HELP command. To view 
the list of HELP topics, type HELP and press the key. For example: 


NDU>HELP(RET ) 


To obtain information about a specific subject, type the HELP command and a topic. 
Then press the key. For example: 


NDU>HELP OPEN(ET) 


5.9 NDU Command Summary for Remote Printers 


NDU provides you with commands that allow you to direct text to a remote node to be 
queued later for printing. Table 5-4 lists each NDU command and its function. The 
remainder of the chapter discusses each command in alphabetical order. 


Table 5-4: NDU Commands for Remote Printers 


Command Function 


CLOSE Requests that NDU end an existing connection to a remote 
print file and queues it for printing and deletion. 


CREATE and OPEN Instructs NDU to create a remote printer file and make it ready 
for use. 

HELP Displays a message explaining the use of the NDU command 
and the meaning of the command parameters. 

SHOW Displays the activity and current state of the virtual disk(s) and 
printer. 
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5.9.1 CLOSE 


The CLOSE command ends the connection between the device NPRN and the file on 
the remote node. The file is then queued to be printed on the remote printer. After the 
file is printed, it is deleted. 


Format 

CLOSE PRINTER 
Example 

NDU>CLOSE PRINTER(RET) 


This command ends the connection between the device NPRN and the printer on the 
remote node. Any subsequent operations to the printer device result in the following 
error message: 


Not ready error writing device NPRN 
Abort, Retry or Ignore? 
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5.9.2 CREATE and OPEN 
The CREATE and OPEN commands function in the same way. 


The CREATE and OPEN commands create a new virtual printer file and make it ready 
for use. The printer file is created and then linked to the device NPRN. 


Format 
CREATE PRINTER NODE node-name [NPRINT file-name] [USER access-info] 
OPEN PRINTER NODE node-name [NPRINT file-name] [USER access-info] 


where 

node-name identifies and locates the printer’s resident node. 

file-name specifies the name of the remote printer file. If you omit fi/e- 
name, aname for the remote printer file is created. 

access-info specifies access control information for the remote node. If the 
access control information is omitted, the access data specified 
with NCP is used instead. (See the entry under USER in Table 
5-3 for a description of access control information.) 

Remarks 


Following a CREATE or OPEN request, NDU displays status information about the 
printer queue followed by the NDU> prompt. 


Examples 
NDU>CREATE PRINTER NODE DUBLIN NPRINT DEMO.TXT USER JONES(RET) 


This command creates a file named DEMO.TXT to be printed at the remote DECnet 
node DUBLIN. 


NDU>OPEN PRINTER NODE PARIS NPRINT LETTER.TXT USER SAM(RET) 


This command opens a file named LETTER.TXT to be printed at the remote DECnet 
node PARIS. 
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5.9.3 HELP 
The HELP command displays information about NDU commands on your screen. 
Format 


HELP | command-verb 
entity 


where 
command-verb is an NDU command for which you want help information. 
entity is an NDU entity for which you want help information. 


Examples 
NDU>HELP(RET) 


The system displays a list of all NDU commands and entities for which help informa- 
tion is available: 


OPEN CLOSE DELETE CREATE SHOW EXIT. HELP 
NODE USER DRIVE NDISK NPRINT ALLOCAT ION ACCESS 


NDU>HELP CREATE(RET) 


The system displays help information for the CREATE command. 
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5.9.4 SHOW 


The SHOW command causes NDU to report on the status of all virtual disk(s) and 
printer. 


Format 


SHOW STATUS 


Examples 
NDU>SHOW STATUS(RET) 


Sample output from this command appears as follows: 


Disk Status/ Access Node/ Socket Reads Writes 

Drive Ndisk User 

H CLOSED 

I CLOSED 

J CLOSED 

K CLOSED 

Printer Status/ Node Socket/ Writes 

Device Nprint User 

NPRN OPEN 1 6) 
155551.THK! 

NDU> 


This display includes the following information: 


The name of the disk drive. 

The drive’s status - OPEN or CLOSED. 
The file name. 

The ACCESS mode — read or write. 


The NODE name, USER name and account information string (no information dis- 
played here). 


The number of the SOCKET you are connected to. (DOS assigns you to a socket). 
The number of completed READ operations. 

The number of completed WRITE operations. 

The name of the printer. 


The printer’s status - OPEN or CLOSED. 


The USER and account information are displayed if you have specified them in the 
OPEN or the CREATE command. If you do not specify this information and it is 
obtained from the NCP database, it is not displayed. 
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Using the DECnet-DOS Mail Utility 


The DECnet—DOS Mail utility lets you send messages and text files to other nodes in the 
network. This chapter describes the Mail utility and explains how to use it. 
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6.1 Running the Mail Utility 


The first time you start the Mail utility, you are prompted for information. The mail 
program uses this information each time you run the utility. The information is stored 
in the initialization file (INIT file) called MAIL.DAT. (This file is contained in the DEC- 
net directory.) If the file does not exist when you start Mail, the program asks you a | 
series of questions and creates the INIT file by storing your answers in MAIL.DAT. You | 
can edit the information in MAIL.DAT at any time using a text editor that is installed on 

your system. 


The initialization file can contain some or all of these mail parameters: 

e REPLY__ADDRESS = nodename::username 

e DEFAULT__NODE = nodename 

e CARBON__COPY = nodename::username 

e¢ EDITOR = pathname 

e PERSONAL__MESSAGE = a line of text | 


The following sections describe these parameters in more detail. 


6.1.1 REPLY_ADDRESS 


A DECnet—DOS node cannot receive mail from other nodes. In order for users to 
respond to mail that is sent from your pc node, they must have a way to return or send 
messages to you. The DECnet—DOS Mail utility provides a way for other users to send 
mail to you on a different node by using the REPLY__ADDRESS parameter. 


You must define the REPLY__ADDRESS parameter when you first run the Mail utility. 
If not, other users will not know where to send their replies. The address consists of a 
node name and a username. The node name can be any node that you want to use for 
receiving mail. The user name should be a name that identifies you as a valid user on the 
specified node. 


When other users receive mail from you, the REPLY__ADDRESS appears as part of the 
SUBJ: line in your message. The node name and user name are included in the ‘‘Reply 
to’ string. For example: 

From: MSDOS: : TOOK: : BROOKS 


To: BERGIL: : PORTER 
SUBJ: GROUP MEETING "Reply to TOOK: :BROOKS" 


In this example, the REPLY__ADDRESS is TOOK::BROOKS. The same address appears 
in the FROM: field. (MSDOS is the name of your local node.) The return address in the 
FROM: field may vary depending on whether or not your message had to be routed 
through another node. However, the ‘‘Reply to”’ field does not change. For this reason, 
the person responding to your message should always use the information in the 
‘Reply to”’ field. 


If you do not define a REPLY__ADDRESS, the FROM: line will reflect only the default 
name DECNETDOS. For example: 
From: MSDOS: :DECNETDOS 


To: BERGIL: : PORTER 
SUBJ: GROUP MEETING 


As indicated in this example, the user Porter will not be able to answer your mail mes- 
sage because the necessary information has been omitted. Be sure to include both a 
node name and your user name when you define the REPLY__ADDRESS. 


6.1.2 DEFAULT_NODE 


If you often send mail to the same node, you can shorten the address for that node by 
defining it as the DEFAULT__NODE. Once you have defined the DEFAULT__NODE in 
the INIT file, you can send mail to any user on that node simply by specifying their user 
name. For example, you can define the DEFAULT__NODE as SPAGS by entering it in 
the INIT file as follows: 


DEFAULT__NODE = SPAGS 
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Whenever you send mail from your pc node to a user on SPAGS, just include the user’s 
name in the TO: field. For example: 


MAIL>SEND(RET) 
To: SAM , JOHN , DAVID 


Subj: Lab work 


In this example, the mail sender program first searches the INIT file for the name of 
your DEFAULT__NODE. When it finds the name SPAGS, it automatically sends your 
message to the users SAM, JOHN, and DAVID on node SPAGS. 


You can also use the DEFAULT__NODE for routing mail messages. If you want to send 
mail to a node that is not defined in your NCP database, the mail program will use the 
DEFAULT__NODE to route your message to the desired node. For example: 


MAIL>SEND(RET) 
To: BEORN: : ANDERSONRET) 


Subj: Weekly report 


In this example, the node BEORN is a node that is not defined in the NCP database. In 
order to send your message to this address, the mail sender program requests that the 
DEFAULT__NODE (SPAGS) forward the message to the user ANDERSON on node 
BEORN. 


If you do not define a DEFAULT__NODE, the mail sender program cannot route your 
mail messages. In addition, you will not be able to use the shortened form for mail 
addresses. You will have to include both the node name and the user name for any mes- 
sages that you send. 


6.1.3 CARBON_COPY 


CARBON__COPY is the address to which a copy of your mail message is sent. Each time 
you send a mail message, a copy of that message will be sent automatically to the 
CARBON__COPY address. This address requires both a node name and a username. 
For example, you can define the CARBON__COPY address as DELON: : BRIAN by enter- 
ing it in the INIT file as follows: 


CARBON__COPY = DELON::BRIAN 


Now, whenever you send mail to another user, a copy of that mail will automatically be 
sent to the user BRIAN on node DELON. This node does not appear anywhere in your 
message. For example: 


MAIL>SEND®RET) 
Te: OLORIN: : PETER 
Subj: Corrected problems 


In this example, your message is sent to the user PETER on node OLORIN as well as to 
the user BRIAN on node DELON. 
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6.1.4 EDITOR 


EDITOR specifies the complete path name for the editor that the mail program will use 
when you want to edit mail messages. You must include the /EDIT switch with a mail 
command if you want to edit a message or a text file before you send it. 


6.1.5 PERSONAL_MESSAGE 


The PERSONAL__MESSAGE is a message that other users see whenever you send them 
mail. The message can contain your name and phone number, or it can be any other 
descriptive text you wish to create. For example, you can create a message containing 
your name and phone extension by entering it in the INIT file as follows: 


PERSONAL__MESSAGE = ‘‘Fred at ext 7227”’ 


When you send a mail message, your personal message appears as part. of the From: 
line. For example: 


From: MSDOS::TOOK: :BROOKS "Fred at ext 7227" 
10° BERGIL: : PORTER 
Subj: Group Meeting "Reply to TOOK: : BROOKS" 


6.2 Starting the Mail Utility 


To start the Mail utility, enter a mail command. You can enter commands using one of 
two methods: 


1. Enter a command directly from the command line. This method allows you to 
include one or more of the following qualifiers with your command: 


e The subject of your message (or a description of a file if you are sending one) 
e The name ofa file (if you are sending one) 
e The address of the person who will receive your message or file 

OR 


2. Enter a command after the Mail prompt (MAIL>). This method allows you to 
include a subject, a file name, and an address, or to be prompted for this informa- 
tion. In addition, you have the option of editing the mail message or file before you 
send it. 


6.2.1 Entering Mail Commands from the Command Line 


When you enter mail commands from the command line, you can include the name of a 
file that you want to send as well as the address of the person who will receive the file. 
For example: 


MAIL ACCTREPORT.TXT BARKER: : JONES(RET) 
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This example sends the file, ACCTREPORT.TXT, to the user JONES on the node 
BARKER. 
You can also include a subject for the file you want to send. For example: 


MAIL/SUBJECT="Here is the accounting report that you requested" 
ACCTREPORT.TXT BARKER: : JONES(RET) 


If you do not include an address for sending a message, the program requests the infor- 
mation by issuing the TO: prompt. For example: 


PL SIEIERT "here is your accounting report" ACCTREPORT .TXT(RED 
Te 


If you do not enter a subject, a file name, or an address, the Mail program responds with 
its prompt, MAIL>. For example: 


MAIL(RET) 
MAIL> 


6.2.2 Entering Mail Commands from the Mail Prompt 


If the Mail prompt (MAIL >) is already on the screen in front of you, you can enter mail 
commands. You can type either MAIL or SEND to send a mail message. The program 
prompts you for an address and then a subject. For example: 


MAIL>MAIL(RET) 
TO: JIMINY: : BOOKER(RET) 


SUBJ: Procedures(RET) 


You can also type MAIL or SEND followed by the name of a file that you want to send. 
The program prompts you for an address and a subject. For example: 
MAIL>SEND RECEIPTS. DAT(ET) 


TO: CURTIN: : JONES(RET) 
SUBJ: You need these figures for your report(RET) 


6.3 Using Distribution Lists 


Distribution lists transmit mail messages to a previously defined group of people. This 
saves having to re-type a list of names each time you send mail to the people on the list. 


If you frequently send mail to the same people, you can place their names in a distribu- 
tion list file. When you then specify the list file as the destination for your mail mes- 
sage, the mail sender forwards the message to all of the names and addresses in the file. 
You can use this file as an addition to the names you have already indicated in the To: 
field. 


The distribution list file contains each user’s mailing address. The address consists of 
the user’s node name and user name. The node name and the user name are always sep- 
arated by a double colon (::), and each address is on a separate line in the file. 
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The following is a sample distribution list: 


BERGIL: :DEERE 
SMAAG: : JOHNS 
ANTICS: :M_OLDFIELD 
ABRUPT: : VOLKER 
NEBULA: :G_HART 


To create a distribution list file, use an editor that is installed in your system. (Refer to 
the appropriate user’s guide for the type of editor you are using.) Enter the node names 
and user names of the people to whom you will be sending mail. Be sure to separate the 
node name and the user name with two colons (::), and enter each address ona separate 
line. 


If you do not want mail to go to some of the people in your distribution list, you can 
edit the list to temporarily eliminate their names. To do this, simply place an exclama- 
tion mark (!) in front of their name. The next time you specify the distribution list, the 
mail program will skip over their names and will not send your message to those users. 
Later, if you want to change the list to include the people you previously excluded, 
simply edit the file and remove the exclamation marks. 


The following is a sample distribution list file with two names temporarily omitted 
from the list. 

'BERGIL: : DEERE 

SMAAG: : JOHNS 

ANTICS: :M_OLDFIELD 


! ABRUPT: : VOLKER 
NEBULA: :G_HART 


In this sample, the users DEERE and VOLKER on nodes BERGIL and ABRUPT will not 
receive your mail message. 


To send mail using a distribution list file, enter the at sign (@) and the name of your dis- 
tribution list file in the ‘‘To:”’ field. 


For example: 


MAIL>SEND(RET) 
TO: FRANCE : : MORGAN , WINTER: :G_SMITH, @DEPART . LIS(RET) 


SUBJ: Previous Month's Earnings 


In this example, the name of the distribution list file is DEPART.LIS. While you can use 
several names and addresses in the To: field, you can only include one distribution list 
file for each message you send. DECnet-DOS does not support multiple or nested dis- 
tribution lists. 


When using distribution list files, make sure the particular file you want to access is in 
the current directory. If it is not, then you must also indicate the name of the directory 
which contains the distribution list file you want to use. 
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6.4 Using Qualifiers 


You can use the qualifiers /EDIT and /SUBJECT with the MAIL and SEND commands. 
These qualifiers can be used alone or combined together. /EDIT lets you edit the mail 
message before you send it. This qualifier invokes the editor you have on your system. 
/SUBJECT lets you include the subject of your message at the same time you enter the 
mail command, which bypasses the need for the SUBJECT: prompt. The following 
examples illustrate different possibilities for using /EDIT and /SUBJECT. 


1. 
MAIL>MAIL/EDIT(RET) 
TO: RENEWS: : TAILOR(RET) 


SUBJ New information for you(RET) 


After you press (once you have completed the subject line), the program invokes 
the editor and clears the screen for you to enter the text of your message. 


Zs 


MAIL>SEND/SUBJECT="New information for you"(RET) 
10: RENEWS: : TAILOR(RET) 


After you press (once you have completed the address line), you can enter the text 
of your message on the line immediately following the address. 


S 
MAIL>SEND/EDIT/SUBJECT="New information for you”(RET) 
TO: RENEWS: : TAILOR(RET) 


After you press (once you have completed the address line), the program invokes 
the editor and clears the screen for you to enter the text of your message. 


6.5 Getting Help for Mail 


Help is available for the Mail utility by typing HELP at the mail prompt. For example: 
MATL>HELP 


You can get help on the following topics: 


EXIT MAIL Examples 
INIT FILE SEND 
MAIL SEND Examples 


Information is also available for the following mail qualifiers: 


/EDIT 
/SUBJECT 


To see HELP text for a specific topic, type HELP followed by the topic. For example: 
MAIL>HELP INIT FILE 


This command displays information about the initialization file. 
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6.6 Mail Command Summary 


The Mail utility provides the following commands for sending mail messages: ( } 


EXIT 

HELP 
MAIL 
SEND 


The following sections describe each of the mail commands in alphabetical order. 


6.6.1 EXIT 

The EXIT command allows you to leave the Mail utility. 
Format 

EXIT 

Examples 


In the following examples, the mail program exits you from the mail utility and returns 
you to the prompt or drive you were using previously. 


MAIL>EXIT(RET) 
< 
or 
MAIL>(CTRLUZ RET ) N j 
ets 
6.6.2 HELP 
HELP provides information about the Mail utility. HELP topics and qualifiers include: 
/EDIT MAIL Examples 
INIT FILE SEND 
EXIT SEND Examples 
MAIL /SUBJECT 
Format 
HELP [topic] 
Examples 


To view the HELP file, type HELP at the mail prompt. For example: 
MAIL>HELP 


To view information for a specific topic, type HELP followed by the topic. For exam- 
ple: 
MAIL>HELP SEND 


This command displays information about how to send mail. / 
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6.6.3 MAIL and SEND 


Both the MAIL command and the SEND command allow you to send mail messages and 
text files to other users in the network. These commands may be used interchangeably. 


Format 
MAIL|/switch] [filename] 


where 
/switch is a valid MAIL (or SEND) switch. The valid switches are: 
/EDIT 
/SUBJECT 
filename is the name of a text file to be sent as a mail message. 
Remarks 


To use the SEND or the MAIL command, type either command at the mail prompt. The 
Mail utility will first prompt you (with the To: prompt) for the name of the user (or 
users) who will receive your message. You can include one or several usernames, as 
well as the name of a distribution list file. The following example requests a mail mes- 
sage to be sent to the user MORGAN on node FRANCE, the user G_SMITH on node 
WINTER, and the addresses in the distribution list file DEPART.LIS. 


Examples 

MAIL>SEND(RET) 

TO: FRANCE: :MORGAN, WINTER: :G_SMITH, @DEPART . LIS(RET) 
SUBJ: 


The utility prompts you for the subject of your message (with the SUBJ: prompt). 
You can avoid the SUBJ: prompt by specifying the /SUBJECT qualifier when you first 
enter the command. For example: 


MAIL>SEND/SUBJECT: "Previous Month's Earnings”(RET) 
TO: FRANCE: : MORGAN , WINTER: :G_SMITH, @DEPART .LI 


The /SUBJECT qualifier can be followed by either a colon (:) or by an equal sign (= ). 
The text of the subject must be enclosed in quotation marks (“" ”’). 


You can include a file specification with SEND or MAIL. This allows you to send a copy 
of a file to users on other nodes. For example: 


MAIL>MAIL/SUBJECT="Monthly Report" MARCH. DAT(RET) 
TO: GUEST : : GAMBOL(RET) 


This command sends the file MARCH.DAT to the user GAMBOL on node GUEST. The 
subject of the file is ‘“Monthly Report’. 
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If you want to edit your message or file before yousendit, use the /EDIT qualifier. 
/EDIT calls in the editor you specified when you first set up your Mail options. When 
you include this qualifier, the Mail utility clears the screen for you to enter the text of 
your message. If you are editing a file before sending it, the text of the file appears on 
the screen. When you have completed your edits, exit from the editor. The mail mes- 
sage (or file) is then sent to all of the users you specified in the TO: section. 


6-10 DECnet-DOS User’s Guide 


» 


7 


Testing the Network 


This chapter describes the Network Test Utility (NTU). It describes the NTU commands 
that you can use to diagnose problems you may have connecting your personal com- 
puter to the network. NTU allows you to display information about your node and 
how it is interacting with the network. However, you cannot set or display informa- 
tion about other nodes in the network. 


You do not need any special technical knowledge to use NTU, but it is helpful to know 
the topology of your network. (The topology indicates which nodes are in the net- 
work, and how they are connected.) A basic understanding of network testing con- 
cepts (such as loopback) is also helpful. 


This chapter is divided into five sections: 


Overview of the Network Test Utility (see Section 7.1) — describes NTU and lists 
the functions you can perform with it. 


Running the Network Test Utility (see Section 7.2) — explains how to start NTU, 
and how to exit from it. This section also describes the sequence of operations per- 
formed by the utility as it tests the network components. 


Getting Help for the Network Test Utility (see Section 7.3) — describes the HELP 
commands and features that are available with NTU. 


Using the Network Test Utility Commands (see Section 7.4) — explains how to use 
the NTU commands and outlines the proper format to use for each command. This 
section also lists the NTU commands. 


The Network Test Utility Commands (see Section 7.5) — describes each of the 
NTU commands in detail. 
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7.1. Overview of the Network Test Utility 


NTU is similar to the Network Control Program (NCP) because it provides a way for 
you to interact with the network. While you can use NCP to set network parameters 
and display information about your network, NTU performs loopback tests and dis- 
plays information. 


You can use NTU to pinpoint problems connecting your personal computer to the net- 
work. Since problems can occur in any of the network components, NTU commands 
let you perform various tests which check the operation of each component. The tests 
check the operation of your local node, the connection to the remote node, and the 
communication hardware between them. 


By starting with your local node and progressing outward to each of the components in 
your network, you can determine which specific component is not Operating properly. 
(If all of your components appear to be working properly, you should contact your net- 
work manager or the manager of the network you are trying to reach. Have the man- 
ager perform further tests to determine the network problem.) 


NTU lets you use loop messages to test the following parts of your network: 
e The local node 

e Aturnaround connector on the line or controller 

e A local or a remote modem (for DDCMP use only) 

° An adjacent node at the circuit level (for DDCMP use only) 

e <Aremote node at the circuit level (for Ethernet only) 

e Aremote node at the application level 


These messages are sent through the communications controller. DECnet-DOS V1.1 
supports either Ethernet connections (using a vendor-supplied Ethernet controller) or 
asynchronous network connections (using the asynchronous serial port, which is 
included with the pc). DECnet—Rainbow V1.1 supports an asynchronous DDCMP net- 
work connection only. 


Some of the NTU tests use a device called a loopback connector to check the operation 
of the various components. The loopback connector is a hardware device that you 
attach to each component as you test it. Loop test messages are sent to the connector 
and returned to the local node. If the messages do not return, or if they do not match 
the original messages that were sent, the problem is likely to be with the component 
you are currently testing. 


The following figures show how you can progressively check the operation of your 
local node, your transceiver cable, your local modem, and your remote modem. These 
examples apply to DDCMP configurations only. 
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Figure 7-1 illustrates the use of the loopback connector on your local node. It is 
attached to the system unit at the controller port. With the connector in this position, 
you can check that your system is working properly (see Section 7.5.11). 
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Figure 7-1: LOOP CIRCUIT Test (to the Loopback Plug on the Controller) 


Figure 7-2 illustrates the use of the loopback connector on the cable that is attached to 
your system unit. With the connector in this position, you can check that the cable con- 
necting your system to the network is operating properly (see Section 7.5.11). 
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Figure 7-2: LOOP CIRCUIT Test (to the Loopback Plug on the Cable) 


Figure 7—3 illustrates the local modem loopback test (see Section 7.5.11). Using this 
test, you can check that your network is operating properly up to the modem. 
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Figure 7-3: LOOP CIRCUIT Test (to the Local Modem) 
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Figure 7—4 illustrates the remote modem loopback test (see Section 7.5.1 1). Using this 
test, you can check that your network is working properly up to the remote modem. 
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Figure 7-4: LOOP CIRCUIT Test (to the Remote Modem) 


When you run the loopback tests, network counters record events that occur while the 
test is running. The counters record the error and traffic information that occurs on the 
network, including events for your local node, line, or circuit. You can zero these 
counters prior to running the loop test by using ZERO CIRCUIT, ZERO LINE, and ZERO 
EXECUTOR. When the test is run, the errors and traffic that are recorded reflect the 
most recent network events. To display the counters after the test has run, use one of 
the following commands: 


e SHOW CIRCUIT COUNTERS 

e SHOW LINE COUNTERS 

°e SHOW EXECUTOR COUNTERS 

The loop tests are performed using the following information: 

e The length of the test message 

e The number of times to send the test message 

e The type of format for the test message 

e The node that will receive the test message and retransmit it back to your node 


NTU performs loop tests and analyzes their results. To perform these functions, NTU 
provides the following options: 


e CLEAR resets all of the default settings that you specified with SET (see Sections 
7.5.1 through 7.5.8). 


¢ EXIT leaves NTU and returns you to the previous prompt (see Section 7.5.9). 


¢ HELP provides a list of topics to assist you in using the NTU commands (see Sec- 
tions 7.3 and 7.5.10). 
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e LOOP tests check the operation of your local node, the connection to the remote 
node, and the communication hardware that connects them. This hardware 
includes local and remote modems (see Sections 7.5.11 through 7.5.14). 


e MIRROR is the network application that is used when a loopback test is performed 
from a remote node to the local node. The mirror allows test messages from a 
remote node to be echoed back to that same remote node (see Section 7.5.15). 


e MONITOR LOGGING continuously displays event logging information on the ter- 
minal screen (see Section 7.5.16). 


e READ LOGGING displays the contents of the event logging buffer (see Section 
73.57). 


e SET lets you specify the default settings for the LOOP commands (see Sections 
7.5.18 through 7.5.27). 


e SHOW displays statistics about node, line, and circuit characteristics. SHOW also 
displays counter statistics (see Sections 7.5.28 through 7.5.37). 


e ZERO resets each of the counters to zero (see Sections 7.5.38 through 7.5.40). 
NOTE 


Some of the NTU commands are identical in format and function to the 
NCP commands of the same name described in Chapter 2. These com- 


mands are: 

EXIT SHOW EXECUTOR 
MONITOR LOGGING SHOW KNOWN LINKS 
READ LOGGING SHOW KNOWN NODES 
SHOW ACTIVE LINKS SHOW LINE 

SHOW ACTIVE NODES SHOW NODE 

SHOW ADJACENT NODE ZERO CIRCUIT 

SHOW CIRCUIT ZERO EXECUTOR 
SHOW DEFAULTS ZERO LINE 


Refer to the command descriptions in Chapter 2 for complete details 
about the NCP commands. 


7.2 Running the Network Test Utility 


Before you run any of the NTU tests, NTU performs a sequence of operations to deter- 
mine if there are any problems with your network components. If there are no prob- 
lems, NTU displays a series of messages. It then displays the NTU prompt (NTU >). For 
example: 


Network Test Utility (NTU) Version 1.1.0 
NTU> 


You can then select one of the test options that are available to you (see Section 7.5). 
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If a problem prevents NTU from running, the utility displays an error message describ- 
ing the problem and the steps you should take to correct it. NTU then exits and returns 
to the previous command level. As an example, NTU will not function properly if you 
have not followed the installation steps correctly. 


7.2.1 Starting the NTU 


To invoke NTU, you can type NTU at the current drive prompt and then press (RET). For 
example: 


E>NTU(RET) 


If there are no problems, the system responds with the NTU startup messages, followed 
by the NTU prompt. You can then enter NTU commands. 


You can also use any of the following methods to start NTU: 


1. Call up an indirect command file, which contains the NTU commands. For exam- 
ple: 
E>NTU @COMMANDS. BAT(RET) 
However, when NTU reaches the end of this command file, it exits. The system 
then returns to the previous prompt or command level. 

2. Enter individual NTU commands from the command line. For example: 
E>NTU LOOP NODE REMOTE(RET) 


This command sends a loop message to the node named REMOTE. 


3. Build a batch file and use that file to execute NTU commands. For example, you can 
create the file LOOP.BAT containing these commands: 


LOOP.BAT: 


NTU ZERO CIRCUIT COUNTER 
NTU ZERO LINE COUNTER 

NTU ZERO EXECUTOR COUNTER 
NTU LOOP NODE FORE 

NTU SHOW EXECUTOR COUNTER 
NTU SHOW CIRCUIT COUNTER 
NTU SHOW LINE COUNTER 


To invoke this batch file, enter the name of the file at the system prompt. For exam- 
ple: 
E>LOOP(RET) 
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The commands in LOOP.BAT let you zero the counters, run a loop test to the node 
FORE, and show the resulting counters (which reflect what happened during the 
loop test). You can redirect the output from the commands in LOOP.BAT to 
another file. For example: 


E>NTU <LOOP.BAT >LOOP.LOG(RET) 
or 
E>NTU @LOOP.BAT >LOOP.LOG 


Either of these commands redirects the output from the LOOP.BAT commands 
into the file LOOP.LOG. 


7.2.2 Leaving the NTU 


To exit from NTU, type the EXIT command at the NTU prompt and then press (RET). For 
example: 


NTU>EXIT(RET) 


You can also use to exit from NTU. Either method causes you to leave NTU, 
and return to the prompt or command level you were using previously. NTU also sets 
the line state ON when it exits. 


7.3 Getting HELP for NTU 


The HELP command provides assistance for each of the NTU commands. To display 
HELP, type the command at the NTU prompt. For example: 


NTU>HELP(RET ) 


The system displays a list of the NTU commands. To display HELP for an individual 
command, enter HELP and a command or a command plus an entity that applies to that 
command. For example: 


NTU>HELP SET(RET) 
NOTE 


Before you can display on-line help text, the file NTUHELP.BIN must 
be installed in the same directory as the DECnet database 
(DECPARM.DAT). 


7.4 Using the NTU Commands 


The NTU commands are made up of several parts. When you enter a command, be sure 
to separate each part with a space. The parts of NTU commands include: 


e The command verb (the command itself) 


e §6The entity (a noun that defines which network component will be affected by the 
command) 
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e The parameter (a definition of how the command will affect the network compo- 
nent) 


e The qualifier (a further definition of how the command will affect the network 
component) 


You do not have to type the entire keyword when you enter it. The system recognizes 
the first three letters of each keyword. For example, to show the default settings, you 
enter: 


NTU>SHO DEF(RET) 


This helps save time if you want to enter a long command string. However, for clarity 
and consistency, all examples in this chapter will show the full command format. 


The parameters used by the SHOW commands are defined in Table 7-1. 
Table 7-1: NTU SHOW Command Parameters 


Parameter Function 
CHARACTERISTICS displays parameters that are set for the specified entity. 
COUNTERS displays error and traffic information for the specified entity. 


A counter displays statistics about the flow of traffic over the net- 
work. The counters also record error conditions and accumulate 
their totals for you. 


Traffic refers to the messages that travel over the network. 


STATUS displays whether the specified entity is available (ON or OFF) for 
communication over the network. 


SUMMARY displays only the most useful information for the specified entity. 
SUMMARY is the default display type. 


Table 7-2 lists variables that are commonly used in NTU commands. They are 
described here to avoid needless repetition in the command descriptions on the fol- 
lowing pages. 
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Table 7-2: 


Qualifier 


account 


circuit-id 


file-id 


node-id 


password 


user-id 


Common NTU Command Variables 


Function 


specifies a string of 1 to 39 alphanumeric characters that you may need to 
access the loopback mirror on a remote node. (This field is not used by most 
systems, including DECnet-DOS and DECnet-Rainbow.) 


specifies either ASYNC-1 or ETHER-1 as the circuit to use for testing net- 
work communications. 


specifies the name of the output file which stores information resulting from 
the execution of an NTU command. 


a decimal number. 


specifies the name or the address of a node. A node name is a 1 to 6 alphanu- 
meric character string that identifies a specific node. A node address is a 
numeric character string consisting of an area number and a specific node 
number. The node address also serves to uniquely identify the node in the 
network. 


specifies a unique character string (1 to 39 alphanumeric characters) that you 
must use to access the loopback mirror on the specified remote node. 


specifies the name of the user (1 to 39 alphanumeric characters) on the speci- 
fied remote node. 


Most systems do not require a user-id, password, or an account for accessing the 
remote loopback mirror. The only time you may need to define these parameters is if 
you receive an error message when trying to connect to the mirror. An example of an 
error message would be: ‘‘Connection Refused’ ’. If the remote test fails and you see this 
type of message, you should then define the necessary information using the SET com- 
mand. If the tests are successful without including any access information, there is no 
need for you to define it. 


When you enter an NTU command, you must provide the command verb, the entity, 
and one or more of the parameters or qualifiers which apply to that command. Be sure 
to separate each of the elements that follow the command with a space. For example: 


NTU>SHOW NODE FROG STATUS(RET) 


This command string requests that NTU display the status of the node FROG. 


7.5 NTU Command Summary 


The NTU commands are presented in this section in alphabetical order. Table 7—3 sum- 
marizes the commands and their functions. 
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Table 7-3: NTU Command Summary 


Command 


CLEAR ACCESS 


CLEAR ACCOUNT 


CLEAR COUNT 


CLEAR DEFAULTS 


CLEAR LENGTH 


CLEAR PASSWORD 


CLEAR USER 


CLEAR WITH 


EXIT 
HELP 


LOOP CIRCUIT 
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Function 


Removes the userid, password, and the account information 
you previously specified with the SET or LOOP command. 


Removes accounting information you previously specified 
with the SET or LOOP command. 


Resets the number of times to send the test message, which 
you previously changed with the SET or LOOP command. The 
default setting is 1. 


Restores the initial settings for each of the loopback com- 
mands, which you previously changed with the SET or LOOP 
command. The USER, PASSWORD, and ACCOUNT strings are 
reset to null (nothing specified). The value for COUNT is reset 
to 1. The value for LENGTH is reset to 40. The setting for 
WITH is reset to MIXED. 


Resets the length of the test message you previously changed 
with the SET or LOOP command. The default length is 40 
bytes. 


Removes the password you previously specified with the SET 
or LOOP command. The string is reset to null (no password 
specified). 


Removes the userid you previously specified with the SET or 
LOOP command. The string is reset to null (no userid speci- 
fied). 


Resets the binary format indicated for the test message to the 
default format, which you previously changed with the SET or 
LOOP command. The default format is MIXED (ones and 
zeroes). 


Exits you from the NTU utility. 


Displays additional information about NTU commands. HELP 
also displays diagrams for some of the loop tests. 


For asynchronous DDCMP configurations: performs a loop 
test on the DECnet circuit out to the connector (which can 
be attached to the controller, the cable, the local or remote 
modem, or an adjacent node). 


For Ethernet configurations: performs an Ethernet loop- 
back test on the local Ethernet. 


(continued on next page) 
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Table 7-3 (cont.): NTU Command Summary 


Command 


LOOP EXECUTOR 


LOOP LINE CONTROLLER 


LOOP NODE nodeid 


MIRROR 


MONITOR LOGGING 


READ LOGGING 


SET ACCOUNT account 


SET CIRCUIT 
SET COUNT n 


SET ECHO 


SET LENGTH n 


SET LINE 


SET LINK 


SET PASSWORD password 


SET USER userid 


SET WITH 
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Function 
Performs a loop test in your local node. 
Performs a loop test to the Ethernet controller. 


Performs a loop test to a remote node, using a node name or 
address that you specify. 


A network application that echoes LOOP NODE messages 
received from a remote node back to the remote node. 


Displays event logging information on your terminal 
screen. 


Displays the contents of the event logging buffer on the 
screen in front of you. 


Specifies the account information to be used for accessing 
the mirror on a remote node. 


Sets specific parameters for the circuit. 


Specifies the number of times to send a test message. The 
number can be from 1 to 65,535. 


Displays the batch file as it is executed. 


Specifies the length of the loopback message to be sent, 
where 7 is the number of bytes. The value of 7 must be no 
greater than 1024. 


Sets the line state to ON or OFF. 
Detaches the sockets and breaks the logical links. 


Specifies the password to be used for accessing the mirror 
on a remote node. 


Specifies the user information necessary for accessing a 
loopback mirror at the remote node. 


Specifies the binary format to use for the loopback message 
you want to send. The message can consist of ONES 
(111111), ZEROES (000000), or a combination of the two 
(011001). The default format is MIXED (011001). 


(continued on next page) 
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Table 7-3 (cont.): NTU Command Summary 


Command 


SHOW ACTIVE LINKS 


SHOW ACTIVE NODES 


SHOW ADJACENT NODE 


SHOW CIRCUIT 


SHOW DEFAULTS 


SHOW EXECUTOR 


SHOW KNOWN LINKS 


SHOW KNOWN NODES 


SHOW LINE 

SHOW NODE nodeid 
ZERO CIRCUIT 
ZERO EXECUTOR 
ZERO LINE 
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Function 


Displays information for all logical links from the executor 
node to other nodes. 


Displays information about all the nodes with currently 
active links to the local node. 


Displays information about the adjacent node (only if you 
are using asynchronous DDCMP communication). 


Displays information about the DECnet circuit. 


Displays the current default settings that you specified with 
the SET command. If you specified USER, PASSWORD, and 
ACCOUNT parameters with the SET command, these 
parameters are also displayed. If you are recording test 
results, this command displays the name of the file being 
used to store the results. 


Displays executor (local node) information. 


Displays information for all logical links known to the local 
node. 


Displays a list of all the nodes known to the local node. You 
can set these nodes by using NCP. 


Displays information about the DECnet line. 
Displays information about a specific node. 
Resets the circuit counters to zero. 

Resets the executor (local node) counters to zero. 


Resets the line counters to zero. 
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7.5.1 CLEAR ACCESS 


f \ The CLEAR ACCESS command removes the user-id, password, and accounting infor- 
| mation that was stored by a previous SET or LOOP command. 


Format 
CLEAR ACCESS 


Example 
NTU>CLEAR ACCESS(RET) 


Cy) 
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7.5.2 CLEAR ACCOUNT 


The CLEAR ACCOUNT command clears the accounting information that was stored by } 
a previous SET or LOOP command. 


Format 
CLEAR ACCOUNT 


Example 
NTU>CLEAR ACCOUNT(RET) 


UO 
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7.5.3 CLEAR COUNT 


( \ The CLEAR COUNT command resets the number that indicates how many times you 
want to repeat a specific test to its default value of 1. 


Format 
CLEAR COUNT 


Example 
NTU>CLEAR COUNT(RET) 


ii 
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7.5.4 CLEAR DEFAULTS 


The CLEAR DEFAULTS command resets all the loopback parameters to their original ( | ) 
values. The original values are: null for user-id, password, and account; 1 for COUNT, 
40 for LENGTH, and MIXED for WITH. 


Format 
CLEAR DEFAULTS 


Example 
NTU>CLEAR DEFAULTS(ET) 


VY 
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7.5.5 CLEARLENGTH 


cr» The CLEAR LENGTH command resets the number that indicates the message length to 
| its default value of 40. 


Format 

CLEAR LENGTH 
Example 

NTU>CLEAR LENGTH(RET) 


«A 
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7.5.6 CLEAR PASSWORD 


The CLEAR PASSWORD command removes the password that was stored by a pre- 
vious SET or LOOP command. 


Format 
CLEAR PASSWORD 


Example 
NTU>CLEAR PASSWORD(RET) 
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7.5.7 CLEAR USER 


«¥ The CLEAR USER command removes the user-id that you initially stored with the SET 
— or LOOP command. 


Format 
CLEAR USER 


Example 
NTU>CLEAR USER(RET) 


Oy 
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7.5.8 CLEAR WITH 


The CLEAR WITH command resets the binary format indicated for the test message to _ 
its default value of MIXED. Nad 


Format 
CLEAR WITH 
Example 


The following example resets the default format to be MIXED. 
NTU>CLEAR WITH(RET) 


VY 
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7.5.9 EXIT 


f , The EXIT command lets you leave NTU. Whenever you issue this command, NTU 
. attempts to restore the DECnet line to the ON state. 


Format 

EXIT 
Examples 
NTU>EX I T(RET) 


You can also use to exit from NTU. 
NTU>(CTRL/Z) 


# 
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7.5.10 HELP 


The HELP command provides information about the NTU commands. Entering HELP . } 
alone results in a display of the available commands. You can further qualify the infor- 

mation you seek by specifying HELP followed by a command name (and optionally an 

entity). 


Format 


HELP [command_verb [entity}] 


where 

command verb specifies the NTU command for which you would like help 
information. 

entity specifies that you would like information about the specified 
command as it relates to this component. 

Example 


NTU>HELP SET COUNT(RET) 
This example displays help text for the SET COUNT command. 
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7.5.11 LOOP CIRCUIT 


The LOOP CIRCUIT command performs loop tests for the DECnet circuit. You can use 
the loop circuit tests for either asynchronous DDCMP configurations or for Ethernet 
configurations. 


If you are using DDCMP, the tests verify that network communication is possible 
between your local node and the following: 


e the loopback plug or controller. 
e the loopback plug or cable. 

e the local modem. 

e the remote modem. 

e the adjacent node. 


If you are using Ethernet, the tests verify that network communication is possible 
between your local node and the following: 


e aspecific remote node. 
e any remote node that responds to the loopback request. 


When you run the loop circuit tests, they check the network path from the local node 
to the hardware level on the remote node, the modem, or the loopback plug. 


NTU performs each test 7 times, as long as the test is successful. (The default value for 
is 1. You can change this value using the SET COUNT command.) When the test is com- 
plete, NTU displays a success message. If the test fails, NTU displays an error message. 


Format (for DDCMP Configurations) 
LOOP CIRCUIT [COUNT ] [WITH ONES/ZEROES/MIXED] [LENGTH 7] 


where 

COUNT n is the number of times to repeat the loop test. The 
default is 1. 

MIXED/ONES/ZEROES indicates that the message type should be mixed 
ones and zeroes, all ones, or all zeroes. The default 
is MIXED. 

LENGTH n is the length of the loop message to be sent. The 
maximum value you can use is 512. The default is 
40. 
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Format (for Ethernet Configurations) 
LOOP CIRCUIT [COUNT n] [WITH ONES/ZEROES/MIXED] [LENGTH n| 
or 


LOOP CIRCUIT NODE node-id 
[COUNT n] [WITH ONES/ZEROES/MIXED] [LENGTH 7] 


Or 


LOOP CIRCUIT PHYSICAL-ADDRESS hh-hh-hh-hb-hb-hb 
[COUNT n] [WITH ONES/ZEROES/MIXED] [LENGTH 77] 


where 

COUNT n is the number of times to repeat the loop test. The 
default is 1. 

MIXED/ONES/ZEROES indicates that the message type should be mixed ones 
and zeroes, all ones, or all zeroes. The default is 
MIXED. 

LENGTH n is the length of the loop message to be sent. The max- 
imum value you can use is 512. The minimum value 
is 46. This is also the default. 

NODE node-id is the name of the designated node to which you 
want to send loop messages. You can use either the 
node’s name or its address. The node must already be 
defined by the NCP command SET NODE. 

PHYSICAL-ADDRESS is a hexadecimal number representing the actual 

hh-hh-hh-hh-hh-hh physical address of the node you are trying to con- 
tact. The range for this number is 0 — F. 

Remarks 


When you issue the LOOP CIRCUIT command, NTU determines whether you are using 
DDCMP or Ethernet on your node. The prompts that NTU returns for this command 
will vary depending upon your node’s configuration. 


When you run the loop circuit test for DDCMP, NTU prompts you with information 
needed to run the test. You may need to perform one of the following operations: 


e Place the loopback plug on the controller. 

e Place the loopback plug on the end of the cable that is attached to the controller. 
e Place the local modem in loopback mode (by pressing a switch on the modem). 

e Place the remote modem in loopback mode (by pressing a switch on the modem). 


e Ifyou are performing a loop circuit test to an adjacent node, make sure the adjacent 
node is set with CIRCUIT STATE SERVICE. 
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When you run the loop circuit test for Ethernet, you do not need to perform any special 
operations. If you issue the command without specifying a responding node, a loop 
request is sent out to the multicast loopback assistance address. This means that any 
node on the Ethernet may reply to the loop request. Once a node responds to this 
request, NTU displays information about the loop message that was sent and the num- 
ber of the responding node. 


Examples 


The following example illustrates a DDCMP loop circuit test. 
NTU>LOOP CIRCUIT(RET) 


LOOP CIRCUIT (DDCMP) - Do one of the following, then press any key to 
begin test. Check the DECnet-DOS User's Guide for details. 


Place loopback plug on controller. 

Place loopback plug on end of cable attached to controller. 

Place local modem in loopback. 

Place remote modem in loopback. 

For circuit loopback to the adjacent node, be sure the adjacent node 
is set with CIRCUIT STATE SERVICE. 


mBWN Fe 


The following example illustrates an Ethernet loop circuit test to a multicast address. 


NTU>LOOP CIRCUIT(RET) 
LOOP CIRCUIT test started at 1-Feb-1986 14:22:34 


Sending loop message l1, 46. 
Message echoed by remote circuit loopback 1, 46 bytes. 
Multicast Loop Circuit echoed by node 55.62 


LOOP CIRCUIT test finished successfully at 1-Feb-1986 14:22:35 
NTU> 


The following example illustrates an Ethernet loop circuit test to the node 55.101 with 
a count of 3. 


NTU>LOOP CIRCUIT NODE 55.101 COUNT 3Q@ED 
LOOP CIRCUIT test started at 4-Feb-1986 15:23:57 


Sending loop message 1, 46. 
Message echoed by remote circuit loopback 1, 46 bytes. 
Sending loop message 2, 46. 
Message echoed by remote circuit loopback 2, 46 bytes. 
Sending loop message 3, 46. 
Message echoed by remote circuit loopback 3, 46 bytes. 


LOOP CIRCUIT test finished successfully at 4-Feb-1986 15:23:58 


NTU> 
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7.5.12 LOOP EXECUTOR 


The LOOP EXECUTOR command invokes the loop test for your local (executor) node. } 
It verifies the operation of your local node by checking the local network software. 
This test verifies that your local node software has been properly installed. 


When you issue this command, NTU performs the test 7 times, as long as the test is suc- 
cessful. (The default value for 7 is 1. You can change this value using the SET COUNT 
command.) 


When the test is complete, NTU displays a success message. If the test fails, NTU dis- 
plays an error message. 


Format 


LOOP EXECUTOR [COUNT 7] [WITH MIXED/ONES/ZEROES] [LENGTH 7] 


where 
COUNT n is the number of times to repeat the loop test. The 
default is 1. 
MIXED/ONES/ZEROES indicates that the message type should be mixed ones 
and zeroes, all ones, or all zeroes. The default is 
MIXED. 
LENGTH n is the length of the loop message to be sent. The max- 
imum value you can use is 512. The default is 40. 
Example 


The following example requests that the loop test be performed 10 times, with mixed 
ones and zeroes, and a message length of 50. 


NTU>LOOP EXECUTOR COUNT 10 WITH MIXED LENGTH 50(RET) 
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7.5.13 LOOP LINE CONTROLLER 


The LOOP LINE CONTROLLER command is used in Ethernet configurations only. It 


performs a loopback test within the local node at the device (or controller) level. 


The loop line controller test requires the use of the DECNA loopback connector (part 
number 12—22196-01). You must attach this connector to the Ethernet controller in 


order to perform this test. 


When you issue the LOOP LINE CONTROLLER command, NTU prompts you with 
information needed to run the test. There are no arguments or switches associated with 


this command. 

Format 

LOOP LINE CONTROLLER 
Example 


The following example illustrates a sample loop line controller test. 


NTU>LOOP LINE CONTROLLER(RET) 
LOOP LINE CONTROLLER (ETHERNET ) 


1. Place the loopback plug on the controller. 
2. Press any key to begin test. 


3. At the end of the test, reconnect the controller to the network. 


LOOP LINE CONTROLLER test started at 5-Feb-1986 11:08:47 


LOOP LINE CONTROLLER test finished successfully at 5-Feb-1986 11:08:49 


NTU> 
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7.5.14 LOOP NODE 


The LOOP NODE command invokes the loop test for the remote node. It verifies that 
your node can communicate with a specified remote node. To perform this test, you 
need to include any network parameters that are necessary for accessing the loopback 
mirror on the remote node. These parameters may include the node-id, the user-id, the 
password, and the account. You can enter these parameters before you run the test by 
using SET commands (see Chapter 2). 


When you issue this command, NTU performs the test 7 times, as long as the test is suc- 
cessful. (The default value for 7 is 1. You can change this value using the SET COUNT 
command.) 


Before running the test, LOOP NODE sets the line state to ON. When the test is com- 
plete, NTU displays a success message. If the test is unsuccessful, NTU displays an error 
message. 


Format 


LOOP NODE node-id USER user-id 
PASSWORD password 
ACCOUNT account 
COUNT n 
WITH ONES/ZEROES/MIXED 
LENGTH n 


where 


node-id specifies the name or the address of a remote node. A 
node name is a 1 to 6 alphanumeric character string 
that identifies a specific node. A node address is a 
numeric character string consisting of an area number 
and a specific node number. The node address also 
serves to uniquely identify the node in the network. 


user-id is the user information you may use for accessing the 
loopback mirror on the remote node. 


password is a unique character string that you may use for 
accessing the loopback mirror on the remote node. A 
user's password consists of 1 to 39 alphanumeric 
characters (some systems restrict password lengths to 
only 8 characters). 


account is alphanumeric information you may need to access 
the remote node’s loopback mirror. 


COUNT n is the number of times to repeat the loop test. 
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ONES/ZEROES/MIXED indicates that the message type should be all ones, all 
zeroes, or mixed ones and zeroes. 


LENGTH n is the length of the loop message to be sent. 
Remarks 


It is not necessary to include access information for all systems. Most systems do not 
require this information for performing the remote node test. 


Example 


The following example specifies the node GRAHAM as the remote node to be used in 
the remote node test. It specifies that the loop message should be repeated 10 times, 
with a length of 40. This example also illustrates a possible system response to the com- 
mand. 


NTU>LOOP NODE GRAHAM COUNT 10 LENGTH 40(RET) 
Connect complete to node GRAHAM 


Remote node maximum buffer size for loopback: 4096 
LOOP NODE test started at 4-FEB-1986 14:32:14 


Sending loop message 1, 40 bytes. 
Receiving loop message 1, 40 bytes. 
Successful send and receive, message l. 
Sending loop message 2, 40 bytes. 
Receiving loop message 2, 40 bytes. 
Successful send and receive, message 2. 
Sending loop message 3, 40 bytes. 
Receiving loop message 3, 40 bytes. 
Successful send and receive, message 3. 
Sending loop message 4, 40 bytes. 
Receiving loop message 4, 40 bytes. 
Successful send and receive, message 4. 
Sending loop message 5, 40 bytes. 
Receiving loop message 5, 40 bytes. 
Successful send and receive, message 5. 
Sending loop message 6, 40 bytes. 
Receiving loop message 6, 40 bytes. 
Successful send and receive, message 6. 
Sending loop message 7, 40 bytes. 
Receiving loop message 7, 40 bytes. 
Successful send and receive, message 7. 
Sending loop message 8, 40 bytes. 
Receiving loop message 8, 40 bytes. 
Successful send and receive, message 8. 
Sending loop message 9, 40 bytes. 
Receiving loop message 9, 40 bytes. 
Successful send and receive, message 9. 
Sending loop message 10, 40 bytes. 
Receiving loop message 10, 40 bytes. 
Successful send and receive, message 10. 


LOOP NODE test finished at 4-FEB-1986 14:32:44 
NTU>EXIT(RET) 
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7.5.15 MIRROR 


The MIRROR command is used for the LOOP NODE test. MIRROR allows the LOOP 
NODE test to be run from a remote system which supports the NCP loop node test to 
your local node. The maximum size of a message that NCP will loop back is 512 bytes. 


Not all loop tests are available on all remote nodes. The tests you can use depend on 
which tests are available at the remote node you want to use. The information required 
to run the test also depends on the remote node you are using. 


The MIRROR command starts up a loopback mirror (DECnet object-id 25), which 
echoes test messages that it receives from a remote node back to that same remote 
node. 


Format 
MIRROR 
Remarks 


When the test run from the remote node is complete, you can press any key to return to 
the NTU command level. 


Example 
NTU>MIRROR(RET) 
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7.5.16 MONITOR LOGGING 


The MONITOR LOGGING command displays network events as they are being logged. 
An event is an occurrence that has potential significance in the operation and/or main- 
tenance of a network. Logging is the process that generates a record of the event. Cap- 
turing this information in a file can be useful to a network support person if network 
problems occur. Refer to READ LOGGING for more information on event recording. 


You can stop the display of information logging by pressing any key on the keyboard. 
(The logging will also stop when there are no more events to be displayed.) If you want 
to stop the display and also exit from NTU, type (CTRUC). The system requests verifica- 
tion with the prompt, ‘‘Terminating process?’’. If you answer YES, NTU exits and 
returns you to the prompt or system you were using previously. If you answer NO, 
monitoring continues. 


For DECnet—DOS systems, event logging is always turned on, and you cannot select 
only certain events to be displayed. After the events are displayed or redirected, they 
are then discarded. 


If an event is lost, NTU displays an error message before displaying the rest of the 
logged events: 


Event type 0.0 Event records lost 


Each event can display the following information: 


Event type nn.nn Name of event type 
Occurred dd-mmm-yyyy hh:mm:ss 
Other event-dependent text 


Format 
MONITOR LOGGING [TO /file-id] 
where 


TO file-id see definition in Table 7-2. 
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Example 
NTU>MONITOR LOGGING(RET) 


The system responds with: 


Events logged as of 17-Jan-1986 11:17:41 
Event type 410 Circuit up 

Occurred 17-Jan-1986 11:18:00 

Adjacent Node: 55.2 (LOWEND) 


Event type 47 Circuit down —- circuit fault 
Occurred 17-Jan-1986 11:18:09 

Adjacent Node: 55.2 (LOWEND) 

Reason: Line synchronization lost 


Event type 410 Circuit up 


Occurred 17-Jan-1986 11:18:15 
Adjacent Node: 55.2 (LOWEND) 
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7.5.17 READ LOGGING 


The READ LOGGING command causes the system to display information about net- 
work events that is contained in the event logging buffer. These events are logged con- 
tinuously. READ LOGGING lets you read the most current network information. The 
information appears on the screen in front of you. 


After events are displayed, they are discarded unless you use the TO file switch to store 
network information in a file. 


If an event is lost, NTU displays the following error message: 
Event type 0.0 Event records lost 


Event messages have the following format: 
Event type nn.nn event-description 

Occurred dd-mmm-yyyy hh:mm:ss 
event-dependent text 

Format 

READ LOGGING [TO /ile-id]| 

where 

TO file-id see definition in Table 7-2. 
Example 


The following example specifies NETWORK.LOG as the file name to use for storing 
current information about network activities. 


NTU>READ LOGGING TO NETWORK. LOGRET) 
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7.5.18 SET ACCOUNT 


The SET ACCOUNT command lets you specify the account to use for accessing the mir- 
ror on a remote node. You can use up to 39 characters to define the account. 


If you want the characters representing the account to be stored in uppercase letters, 
simply type the characters. If you do not want the characters to be stored as uppercase, 
place the string in quotation marks. For example: 


abc will be stored in the database as ABC 


‘‘Aab”’ will be stored in the database as Aab 


Format 

SET ACCOUNT account 

where 

account is alphanumeric information you may need to access the adja- 
cent node’s loopback mirror. 

Example 


The following example specifies SAM as the account to use for accessing the remote 
node’s mirror. 


NTU>SET ACCOUNT SAMRET) 
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7.5.19 SET CIRCUIT 


The SET CIRCUIT command defines or modifies circuit information. Most parameters 
are set by your network coordinator. Therefore, you must obtain this information 
from that person. 


Format 
SET CIRCUIT |circuit-id| HELLO TIMER seconds 
OWNER (DECnet 
MOP 
SERVICE (DISABLED 
ENABLED 
STATE (ON 
OFF 
where 
CIRCUIT [circuit-id] specifies the circuit (either ASYNC-1 or ETHER-1) 
for which parameters are to be defined or modified. 
HELLO TIMER seconds specifies the frequency of routing hello messages 
sent to the adjacent node over the circuit. The valid 
range is 1 to 8191 seconds. The default is 30. 
OWNER specifies the circuit owner. 
DECnet is the default setting. 
MOP is required for running loopback tests. 
SERVICE sets the circuit’s service state. The default is 
ENABLED. 
DISABLED specifies that the circuit is unavailable for service 
operations. 
ENABLED specifies that the circuit is available for special net- 
work activity such as loopback testing. 
STATE sets the line’s operational state to ON or OFF. 
ON allows network traffic to flow over the circuit. This 
is the normal operational state. 
OFF allows no traffic to flow over the circuit. The circuit 
is unavailable for any network activity. 
Example 


NTU>SET CIRCUIT ASYNC-1 OWNER DECnet(RET) 


This command identifies the owner of circuit ASYNC-1 as DECnet. 
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7.5.20 SET COUNT 


The SET COUNT command lets you specify the number of times to repeat any of the 
NTU tests. The default value is 1, but you can change this at any time using SET - 
COUNT. You can assign any value that is in the range of 1 to 32,767. 


The value you set remains in effect for each test until you reset it using this command, a 
loop command, or a CLEAR command, or until you exit from NTU. 


Format 

SET COUNT n 

where 

n is the numerical value you assign for the number of times to repeat each test. 


Example 


The following example specifies that the NTU tests be repeated 8 times. 
NTU>SET COUNT 8(RET) 


ww 
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7.5.21 SET ECHO 


The SET ECHO command determines whether a redirected input file is displayed on 
your screen as the file is executed. The default is OFF (no echo). 


Format 
SET ECHO (ON 
OFF 
where 
ON turns the echo on, causing the file’s contents to be displayed on the 
screen as the file is executed. 
OFF turns the echo off. 
Example 


NTU>SET ECHO ON(RET) 


This command causes the redirected input from a file to be displayed on the screen. 
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7.5.22 SET LENGTH 


The SET LENGTH command lets you specify the length of the test messages to be sent ( ] 
over the network. The default value is 40, but you can change this at any time using SET 
LENGTH. You can assign any value from 1 up to 512. 


The value you set remains in effect for each test until you reset it using this command, a 
loop command, or a CLEAR command. 


Format 
SET LENGTH n 
where 


n is the numerical value you assign for the length of each message. 


Example 


The following example specifies the length of each test message to be 100 bytes. 
NTU>SET LENGTH 100(RET) 
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7.5.23 SET LINE STATE 


This command allows you to turn the state of the line to OFF or ON. The line is the 
communication path that connects your node to the adjacent node. When the line state 
is OFF, no communication is possible. 


Setting the line state to OFF allows you to disconnect cables and attach the loopback 
connector (in order to run the loop tests) without disrupting the performance of other 
devices in your network. 


NOTE 


If you are performing a loop test to a remote node, do NOT set the line 
state to OFF. 


When you have completed testing, you can reset the line state to ON. You can then 
continue to use other NTU commands. 


Format 

SET LINE [line-id| STATE (OFF 
ON 

Remarks 


The SET LINE STATE command does not change any of the line parameters that are cur- 
rently in effect. To change line parameters, you must exit from NTU. You can then use 
the SET LINE command while you are in NCP. See Chapter 2 for information about set- 
ting and changing line parameters. 


Example 


The following example sets the line state to OFF. 
NTU>SET LINE STATE OFF(RET) 
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7.5.24 SET LINK 


The SET LINK command terminates logical link connections that are associated with a 
specific socket. The socket is also detached. 


Format 
SET LINK socket STATE OFF 


where 


LINK socket specifies the socket to be detached. 
STATE OFF turns the logical link off. 
Remarks 


Use this command only if you are familiar with the socket level programming interface. 
If the socket option SO__KEEPALIVE has been set, the socket cannot be terminated. 
Refer to the DECnet-—DOS Programmer’s Reference Manual for additional informa- 
tion. 

Example 


NTU>SET LINK 3 STATE OFF(RET) 


This command detaches socket 3 and breaks its logical links. To determine the socket 
number, use the SHOW KNOWN LINKS command. 


y 


y 
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7.5.25 SET PASSWORD 


The SET PASSWORD command lets you specify the password to use for accessing a 
mirror on the remote node. You can use up to 39 characters to define the password. 


If you want the characters representing the password to be stored in uppercase letters, 
simply type the characters. If you do not want the characters to be stored as uppercase, 
place the string in quotation marks. 


For example: 
Money will be stored in the database as MONEY 


‘‘Book’’ will be stored in the database as Book 


Format 

SET PASSWORD password 

where 

Password is the unique string of characters you need to access the remote node’s 
mirror. The password can consist of 1 to 39 alphanumeric characters. 

Remarks 


Some systems restrict the length of passwords to a maximum of 8 characters. 
Example 


The following example specifies EARNEST as the password to use for accessing the 
mirror on the remote node. 


NTU>SET PASSWORD EARNEST(RET) 
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7.5.26 SET USER 


The SET USER command lets you specify the access control information necessary for 
accessing the mirror on the remote node. If you decide to provide the user’s name, you 
must also provide the appropriate password for that name. 


If you want the characters representing the user’s name or address to be stored in 
uppercase letters, simply type the characters. If you do not want the characters to be 
stored as uppercase, place the string in quotation marks. 


For example: 
Worthy will be stored in the database as WORTHY 
‘“‘WinTer”’ will be stored in the database as WinTer 
Format 
SET USER [user-id] 


where 

user-id is the user information required to access the mirror on the remote 
node. This information can consist of 1 to 39 alphabetic characters. 

Example 


The following example specifies WARDEN as the user who receives the test message at 
the remote node. 


NTU>SET USER WARDEN@ET) 
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7.5.27 SET WITH 


a’ The SET WITH command lets you specify the type of format to use for sending loop- 

| back messages. The format is always binary (ONES and ZEROES), but you have a choice 
as to how the binary numbers are arranged. There are three ways to arrange the binary 
format: 


e All ONES (11111111) 

e All ZEROES (00000000) 

e Mixed ONES and ZEROES (01010101) 
The default format is MIXED. 


Format 
SET WITH (ONES 
ZEROES 
MIXED 
where 
ONES indicates you want to send only ONES (11111111) in the test message. 
ZEROES indicates you want to send only ZEROES (00000000) in the test mes- 
sage. 
ec” MIXED indicates you want to send both ONES and ZEROES (01010101) in the 
| test message. This is the default. 
Examples 


The following example specifies a mixture of ONES and ZEROES as the format to use in 
the test message. 


NTU>SET WITH MIXED(RET) 


The following example specifies that only ONES be used as the format for the test mes- 
sage. 


NTU>SET WITH ONES(RET) 
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7.5.28 SHOW ACTIVE LINKS 


The SHOW ACTIVE LINKS command displays summary type information for all active 
links between the executor node and the adjacent node (or other remote nodes with WS 
active logical links to your node). 


Format 
SHOW ACTIVE LINKS [TO file-id] 


Example 
NTU>SHOW ACTIVE LINKS(RET) 


UO 
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7.5.29 SHOW ACTIVE NODES 


é \ The SHOW ACTIVE NODES command displays the executor node, the adjacent node, 
| and a list of all the nodes that currently have active links to your local node. 


Format 
SHOW ACTIVE NODES [TO /ile-id] 
Exampie 


The following example displays a list of all the active nodes that currently have logical 
links to your node. 


NTU>SHOW ACTIVE NODESRET) 


ie 
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7.5.30 SHOW ADJACENT NODE 


The SHOW ADJACENT NODE command displays information for the adjacent node. 
This command only applies to asynchronous DDCMP communication. 


Format 

SHOW ADJACENT NODE [TO /ile-id] 
Example 

NTU>SHOW ADJACENT NODE(RET) 
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7.5.31 SHOW CIRCUIT 
The SHOW CIRCUIT command displays information about the specified circuit. 
Format 


SHOW CIRCUIT [circuit-id) [CHARACTERISTICS | [TO file-id| 


COUNTERS 
STATUS 
SUMMARY 
where 
circuit-id identifies the circuit (either ASYNC-1 or ETHER-1) for 


~ which you want information displayed. 


CHARACTERISTICS see definitions in Table 7-1. 
COUNTERS 

STATUS 

SUMMARY 


Remarks 


Circuit counters monitor traffic and errors on individual circuits. You can periodically 
check the counters for the circuit to assess its performance and to determine if there are 
any problems. 


Example 


The following example displays the counters for your circuit. 
NTU>SHOW CIRCUIT ASYNC-1 COUNTERSRET) 
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7.5.32 SHOW DEFAULTS 


The SHOW DEFAULTS command displays all of the current default values set either by ( } 
the system or with the SET or LOOP command. SHOW DEFAULTS displays the values : 
for the following: 


e Loop Count 

e Data Length 

e Data Type 

e §6User-id (if applicable) 

e §©6©Password (if applicable) 
e Account (if applicable) 
Format 

SHOW DEFAULTS 
Example 


The following example displays all the defaults that are currently set for use with the 
NTU commands. 


NTU>SHOW DEFAULTS(RET) 
NTU Defaults 


Loop Count -s j User-id = WY 
Data Length = 40 Password = 

Data Type = MIXED Account = 

NTU> 


VY 
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7.5.33 SHOW EXECUTOR 

The SHOW EXECUTOR command displays information about the local node. 
Format 

SHOW EXECUTOR FT CHARACTERISTICS ] [TO /ile-id| 


COUNTERS 
STATUS 
SUMMARY 
where 
CHARACTERISTICS see definitions in Table 7-1. 
COUNTERS 
STATUS 
SUMMARY 
Example 


The following example displays the characteristics of your executor node. 
NTU>SHOW EXECUTOR CHARACTERIST ICS(RET) 
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7.5.34 SHOW KNOWN LINKS 


The SHOW KNOWN LINKS command displays summary type information for all logi- 
cal links known to the local node. 


Format 
SHOW KNOWN LINKS [TO file-id| 


Example 
NTU>SHOW KNOWN LINKS(ET) 
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7.5.35 SHOW KNOWN NODES 


The SHOW KNOWN NODES command displays a list of all nodes that are known to 

| ~  _DECnet on your local node. You can set these nodes by using NCP. You can perform 
NTU tests (those that require the use of node names) only to nodes that are known by 
your system. 


Format 
SHOW KNOWN NODES [TO /file-id] 
Example 


The following example displays the nodes that have been defined in your network 
database. 


NTU>SHOW KNOWN NODES(RET) 


Node Volatile Summary as of 1-FEB-1986 2:31:18 


Node Node Active LAT Account 
Address Name Links Information 
4.10 SMAUG @) L 
4.19 ELROND 6) 
4.30 OLORIN @) M 
4.209 BAGELS 0 
7.110 KL1026 6) 
7.116 KL2116 0 LM 
ae’ 7.120 KL2102 0 
/ DD.2 LOWEND 0 /TESTER/password/TESTACCT 
55.165 GODIVA @) 


& 
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7.5.36 SHOW LINE 


The SHOW LINE command displays information about the DECnet line (ASYNC-1 or 
ETHER-1) that you are using to communicate over the network. _ 


Format 


SHOW LINE [line-id] [CHARACTERISTICS ] [TO file-id| 


COUNTERS 
STATUS 
SUMMARY 
where 
line-id identifies the line (ASYNC-1 or ETHER-1) for which you 


want information displayed. Since there is only one line to 
use for each configuration in both DECnet-DOS V1.0 and 
DECnet—DOS V1.1, the line-id is optional. 


CHARACTERISTICS see definitions in Table 7-1. 
COUNTERS 

STATUS 

SUMMARY 


Remarks 


Line counters monitor traffic and errors on individual lines. You can periodically | ; 
check the counters for the line to assess its performance and to determine if there are a 
any problems. 


Example 


The following example displays status information about your line. 
NTU>SHOW LINE STATUS(RET) 
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7.5.37 SHOW NODE 


The SHOW NODE command displays information about a remote node, which you 
specify by its name or address. The node information appears on the screen in front of 
you. 


Format 
SHOW NODE node-id| STATUS |TO file-id| 
SUMMARY 

where 

node-id specifies the name or the address of the node for which you 
want to display information. A node name is a 1 to 7 alphanu- 
meric character string that identifies a specific node. A node 
address is a numeric character string consisting of an area 
number and a specific node number. The node address also 
serves to uniquely identify the node in the network. 

STATUS see definitions in Table 7-1. 

SUMMARY 

Remarks 


If you are checking the status of a particular node, that node’s name and address must 
be in the node database. You can use NCP to establish a node database. 


Example 


The following example displays the characteristics for the node GRAHAM. 
NTU>SHOW NODE GRAHAM CHARACTERIST ICS(RET) 
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7.5.38 ZERO CIRCUIT 


The ZERO CIRCUIT command resets all the counters on the circuit to zero. The coun- 
ters display statistics about the flow of network traffic and messages as they travel in 
and out of your node. The counters also record error conditions and accumulate their 
totals for you. 


Format 


ZERO CIRCUIT [circuit-id] [COUNTERS] 


where 

circuit-id specifies the circuit (either ASYNC-1 or ETHER-1) for which coun- 
ters are to be zeroed. Since there is only one circuit to use for each 
configuration in both DECnet-DOS V1.0 and DECnet-—DOS V1.1, the 
circuit-id is optional. 

Remarks 


When you zero the counters, any information about error conditions and their totals is 
erased. 


Example 


The following example resets the counters for your circuit to zero. 
NTU>ZERO CIRCUIT ETHER-1(RET) 
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7.5.39 ZEROEXECUTOR 


The ZERO EXECUTOR command resets all the counters for your local node to zero. 
The counters display statistics about the flow of network traffic and messages as they 
travel in and out of your node. The counters also record error conditions and accumu- 
late their totals for you. 


Format 
ZERO EXECUTOR [COUNTERS] 
Remarks 


When you zero the executor counters, any information about error conditions and 
their totals is erased. 


Example 


The following example resets the counters for your local node to zero. 
NTU>ZERO EXECUTOR(RET) 
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7.5.40 ZEROLINE 


The ZERO LINE command resets all the counters for your line to zero. The counters asl 
display statistics about the flow of network traffic and messages as they travel in and - 
out of your node. The counters also record error conditions and accumulate their 

totals for you. 


Format 


ZERO LINE [line-id] [COUNTERS] 


where 

line-id specifies the line (either ASYNC-1 or ETHER-1) for which counters 
are to be zeroed. Since there is only one line to use for each configura- 
tion in both DECnet—DOS V1.0 and DECnet—DOS V1.1, the line-id is 
optional. 

Remarks 


When you zero the counters, any information about error conditions and their totals is 
erased. 


Example 


The following example resets all the counters for your line to zero. 
NTU>ZERO LINE ETHER-1(RET) 
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NCP Error Messages 


A.1 Introduction 


Some common NCP error messages are listed on the following pages. An explanation is 
also included with each error message. 


A.2 Types of NCP Error Messages 
NCP error messages fall into three categories: 


e Command line errors. These messages are displayed when you use the incorrect 
syntax for a command line. 


e File Input/Output (I/O) errors. These messages are displayed when you try to 
access MS—DOS files. 


e Network errors. These messages are displayed when you try to run NCP ona sys- 
tem where network support, or some part of it, is missing or not working properly. 


You may also see some NTU error messages while running NCP. The NTU messages are 
also included in this appendix. 


SAaXIGNAddV 


A.3 Command Line Errors 
The messages listed in this section are all related to accessing MS—DOS files. 
Cannot set DDCMP parameter in Ethernet configurations. 


You are running DECnet—DOS over an Ethernet connection, and you tried to set a 
parameter used only by DDCMP asynchronous lines. 


Action to be taken: Use a different parameter, or reconfigure your connection for 
Ethernet communication. 


Cannot set Ethernet parameter in DDCMP configurations. 


You are running DECnet—DOS on an asynchronous line, and you tried to set a 
parameter used by Ethernet. 


Action to be taken: Use a different parameter, or reconfigure your connection for 
DDCMP communications. 


Could not find node address with node name = node name. 
The node address and node name pair did not match. 


Action to be taken: Check your list of node names and node addresses and attempt to 
execute the NCP command again. 


Could not find node name with node address = node address. 
NCP was unable to find the node name defined by the specific node address. 


Action to be taken: Check your list of node names and node addresses and try to exe- 
cute the NCP command again. 


Executor is in wrong state. 


The executor is not in the proper state for changing the parameter you specified. 
(For example: you cannot set the EXEC NAME or EXEC ADDR when the state is 
ON.) 


Action to be taken: Use the DEFINE EXECUTOR command rather than SET EXECU- 
TOR. 


Line is in wrong state. 


The line is not in the proper state for changing the parameter you specified. (For 
example: you cannot change the line speed while the line state is ON.) 


Action to be taken: Change the line state first, then change the parameter. 
Node address must be in the range 1 to 1023. 
The node address has exceeded the valid range. 


Action to be taken: Enter a node address that is in the range of 1 to 1023. 
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Node area must be in the range 1 to 63. 

The area number has exceeded the valid range. 
Action to be taken: Enter a node area that is in the range of 1 to 63. 
Node name already defined for another node number. 


You tried to define a node name that has already been matched to a different node 
number. 


Action to be taken: Select another name to apply to this node number. 
Node name must contain an alphabetic character. 


The node name you defined did not contain any alphabetic characters. Node names 
can consist of 1 to 6 alphanumeric characters, but at least one character must be a 
letter. 


Action to be taken: Re-define the node name using at least one letter. 
Node number already defined for another node name. 


You tried to define a node number that has already been matched to a different 
node name. 


Action to be taken: Select another number to apply to this node name. 
Value out of range; check the documentation or type HELP. 
The value you selected for this parameter is not within the valid range. 


Action to be taken: The values for NCP and NTU parameters are defined in Chapters 2 
and 7, respectively. Typing HELP will also provide the valid ranges for these parame- 
ters. Check the valid range for the parameter you want to define, then enter a correct 
value. 


Maximum characters in an executor ID is 32. 
The identification string for the executor node was invalid. 


Action to be taken: Enter an identification string that is in the range of 1 to 32 alphanu- 
meric characters. 


The maximum characters in an account is 39. 
The number of characters in the account string exceeded the valid range. 


Action to be taken: Enter an account number that is in the range of 1 to 39 alphanu- 
meric characters. 


The maximum characters in a node name is 6. 
The number of characters in the node name was invalid. 


Action to be taken: Enter a node name with a maximum of 6 alphanumeric characters. 
At least one of the characters must be alphabetic. 
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The maximum characters in a password is 39. 


The number of characters in the password was invalid. 


Action to be taken: Enter a password with a maximum of 39 alphanumeric characters. 
The maximum characters in a user ID is 39. 
The number of characters in the user identification string was invalid. 


Action to be taken: Enter an identification string with a maximum of 39 alphanumeric 
characters. 


The maximum characters in a receive password is 32. 
The number of characters in the receive password was invalid. 


Action to be taken: Enter a receive password with a maximum of 32 alphanumeric char- 
acters. 


The maximum characters in a transmit password is 32. 
The number of characters in the transmit password was invalid. 


Action to be taken: Enter a transmit password with a maximum of 32 alphanumeric 
characters. 


“User command error 


The command line contains an invalid or missing keyword or parameter. The 
incorrect command line will be displayed with this error message on the next 
line. The © (circumflex) will point to the portion of the command line that was 
incorrect. 


Action to be taken: Request on-line help for the specific command by using the NCP 
command HELP. 
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A.4 File Input/Output (I/O) Errors 
The messages listed in this section are all related to accessing MS-DOS files. 
Could not open file: { file name} 


The file was not found on the default database device in the \DECNET directory or 
an MS-DOS error occurred while you attempted to create or open the file. 


Action to be taken: Refer to the DECnet—DOS Installation Guide or the DECnet—Rain- 
bow Installation Guide for details on the \DECNET directory. 


Could not read from file: { file name} 


An error occurred while you attempted to read from the file. The file may not have 
been properly created/opened, an attempt to read past the end of the file may have 
occurred, or the file may not have been found in the default database device in the 
\DECNET directory. 


Action to be taken: Contact the person responsible for your network for assistance. 
Could not seek in file: { file name} 


An error occurred while you attempted to modify the current seek position in the 
file. 


Action to be taken: Contact the person responsible for your network for assistance. 
Could not write to file: { fi/e name} 


An error occurred while you attempted to write data to the file. The file may not 
have been properly created/opened, or the disk may be full. 


Action to be taken: Contact the person responsible for your network for assistance. 
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A.5 Network Error Messages 


The messages listed in this section are displayed when you try to run NCP on a system 
where network support (or some part of it) is missing or not working properly. 


Network Error: Can’t assign requested address 


A request to set up a node name and node address from a remote node has failed. 
The node name and node address supplied by the user was not recognized by the 
local or remote node. 


Action to be taken: You should specify a different node name and node address. Retry 
the operation. 


Network Error: Connection timed out 


A request to set up a node name and node address from a remote node has failed. 
The time period that is allowed for connecting to the remote network management 
listener has expired. 


Action to be taken: Set the executor’s timeout parameters to longer periods of time. 
Try the command again. 


Network Error: Executor is in wrong state 


An attempt to set a specific network parameter has failed. This occurs when you try 
to set the executor’s node name or node address and the executor’s state is already 
ON. 


Action to be taken: Delete the DECPARM.DAT file in your \DECNET directory. Run 
the SETUP program and @NCP.TXT file as detailed in the DECnet—DOS Installation 
Guide or the DECnet—Rainbow Installation Guide. 


Network Error: Host is unreachable 


A request to set up a node name and node address from a remote node has failed. 
The remote node cannot be reached. 


Action to be taken: Try a different remote node. 
Network Error: Line is in wrong state 


An attempt has been made to set certain line parameters when the line state is 
already ON. 


Action to be taken: You must first set the line state to OFF. Then use the SET LINE com- 
mand to modify certain line parameters. Then turn the line state to ON again. 
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Network Error: Network is down 
An attempt was made to access the network with the executor state OFF. 


Action to be taken: Verify that the executor’s node address (and name) has been set. Set 
the executor state to ON with the SET EXECUTOR command, and turn the line state to 
ON with the SET LINE command. 


Network Error: Network is unreachable 
The DECnet driver was not properly installed. 


Action to be taken: See the DECnet-DOS Installation Guide or the DECnet—Rainbow 
Installation Guide for installation instructions. Repeat the installation procedure. 


Network Error: No response from object 


A request to set up a node name and node address from a remote node has failed. 
The logical link connection is broken, or the remote network management listener 
has failed. 


Action to be taken: Try to execute your network request again. You can increase the 
executor’s timeout period or try to make a connection to a different remote node. 


Network Error: No such process 


A request to set up a node name and node address from a remote node has failed. 
The remote node has no network management listener object. 


Action to be taken: Try another remote node. 
Network Error: Permission denied 


An attempt was made to turn the executor state to ON when the executor’s address 
was not set. An attempt was made to set the line state to ON when the executor’s 
state is OFF. 


Action to be taken: Use the SET EXECUTOR command to set the executor’s node 
address, then turn the executor state ON with the SET EXECUTOR command. 


To turn the line ON, first set the executor’s state to ON. Then set the line state to ON 
with the SET LINE command. 


Network Error: Socket operation on non-socket 
The specified socket number was invalid. 


Action to be taken: Specify a valid socket number using the SET LINK command. Refer 
to the DECnet-DOS Programmer’s Reference Manual for more details. 
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A.6 NTU Errors 


When you test the network using NTU commands, you may see the following error \ } 
messages in addition to the NCP error messages. 


Please run NCP to SET NODE n NAME. 


There is no node name defined for performing the NTU loop tests. 


Action to be taken: Be sure you have defined the proper node name to use for perform- 
ing loop tests. You can define the name using the NCP command SET NODE 7 NAME. 


Cannot access information about executor node. Please check that the DECnet- 
DOS network driver is installed and that NCP runs to: 


SET EXEC ADDR node address NAME node name 
SET EXEC STATE ON 


You have not defined the executor node name and address. 


Action to be taken: Make sure DECnet—DOS is installed and that you can run NCP. Then 
use the NCP commands to define the executor node name and address and to turn the 
executor state ON. 
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NFT Error Messages 


When an NFT error occurs, you should receive one or more of the error messages listed 
in this appendix. 


If you are accessing a remote system and the remote node reports an error for which no 
text has been defined, the following message is displayed: 


DAP error reported by remote node: error code/error code 


The error message consists of a pair of DAP error codes in octal. The first error code 
indicates a specific error type. The second error code identifies the specific reason for 
that error. 


To determine the meanings of the displayed error codes, refer to the Appendix section 
of the DECnet—DOS Programmer’s Reference Manual. If you need further assistance, 
contact your network coordinator. 


If a local error occurs for which there is no defined text, the following message is dis- 
played: 


Unexpected network error, ERRNO value: n 
where 7 is in decimal. 


If you receive either of these messages, see your network coordinator. 


B.1 Types of NFT Error Messages 
NFT error messages fall into three general categories: 
e Command line error messages 


These messages are displayed when you mistype part of a command line (such as 
the verb or a switch). For example: 


NFT>COPI PAGE1.TXT LONDON: :PAGE1.TXT;1 
Error: Unrecognized command: COPI 
Where the COPY command is mistyped. 

e =File Input/Output (I/O) errors 


These messages are displayed when you are accessing a local or remote file or sub- 
mitting a remote file. Remote file I/O error messages are displayed on two lines: 


e The first line states the problem. 


e The second line explains why the problem occurred and the line begins with 
the word “‘Because’’. These messages are referred to as secondary messages, 
and are listed at the end of this appendix. 


For example: 


Error Opening File: node-name filename. typ 
Because cannot assign address — possibly node name is undefined. 


This message indicates that you typed a remote node name that was not previ- 
ously defined. 


e Network errors 


These messages are displayed when you try to run NFT ona system where network 
support, or some part of it, is missing or not working properly. 


Within each category, the messages are listed in this appendix alphabetically. 


When a command line specifies multiple operations and an error is encountered during 
One operation, NFT tries to execute subsequent operations, even after the error has 
been detected. 
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B.2 Command Line Error Messages 
The error messages listed in this section are all related to the syntax of a command line. 
Error: Cannot APPEND to list of files. 


You tried to append one or more files to the end of more than one file. You can 
have only one output file. 


Error: Cannot APPEND to wildcard file name. 


You included a wildcard in the output file name when you tried to append an input 
file to an output file. 


Error: Cannot COPY from wildcard specification to explicit files. 


You tried to copy multiple files using a wildcard while you wanted the output files 
to have specific names or file types. 


Error: Cannot SUBMIT list of files. 


You tried to submit more than one remote command file (in a list) to be run on the 
remote node. 


Error: Command string too long. 

The command line you typed was longer than 256 characters. 
Error: File lists not supported for DELETE command. 

You tried to delete a list of files. You can only delete multiple files using wildcards. 
Error: File lists not supported for DIRECTORY command. 


You tried to display a directory of a list of files. You can only display multiple file 
names using wildcards. 


Error: Illegal ALLOCATION quantity: text 


You used the /ALLOCATION switch with the COPY command and specified a non- 
numeric value. 


Error: Illegal Maximum Record Size: value 


You used the /MRS switch with the COPY command and specified either a non- 
numeric value or a value outside of the range of 0 to 1024. 


Error: Illegal VFC amount: value 


You used the /VFC switch and specified either a non-numeric value or a value that 
is less than O or greater than 255. 


Error in allocation amount 


You used the /ALLOCATION switch without a value. Please supply one. 
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Error in allocation quantity 


You used the /ALLOCATION switch with the COPY command and the remote : 
node did not accept this value. a, 


Error in maximum record size 


You used the /MRS switch with the COPY command and the remote node did not 
accept the value you specified. 


Error in VFC size. 


You used the /VFC switch with the COPY command and specified a fixed length 
header which was not accepted by the remote node. 


Error: Quoted local files are illegal. 


You enclosed a local file specification in quotation marks (‘‘). Quotation marks are 
used only for remote file specifications. 


Error: Too many file names in list. Limit is 10. 


You included more than ten file names in a list (for example, with the APPEND 
command). 


Error: Two paths in a row. 


You specified more than one path name without specifying the corresponding file 
names in between. - 


Error: Unrecognized command: command UO 


You mistyped an NFT command or tried to use a command that NFT could not rec- 
ognize. 


Error: Unrecognized /CC option: option 


You used the /CC switch and specified an incorrect record attribute. The attributes 
must be one of the following: 


None — No attributes 

FTN — FORTRAN carriage control 

CR — Implied carriage return/line feed 
PRN — Fixed header with carriage control 


Error: Unrecognized switch: switch 
You mistyped the name of a switch or used a switch that NFT could not recognize. 
Error: Wildcards are not supported in file name lists. 


You tried to list files using wildcards (for example, with the APPEND command). 
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Warnings 


The following messages are warnings. When they are displayed, the current operations 
will continue. 


Print switch not supported with this command. 


You used the /PRINT switch with a command that does not support the switch (for 
example, DELETE). 


Warning: Cannot DELETE both remote and local files. 
xxx file name(s) will be ignored. 


You specified a local and a remote file to be deleted. NFT deletes the file you listed 
first. Therefore, if you listed the remote file name first, xxx is replaced by the word 
Local. If you listed the local file name first, xxx is replaced by the word Remote. 


Warning: Cannot perform DIRECTORY for both local and remote files. 
xxx file name(s) will be ignored. 


You requested a directory listing of both remote and local file names. NFT displays 
the directory you listed first. Therefore, if you listed the remote directory first, xxx 
is replaced by the word Local. If you listed the local directory first, xxx is replaced 
by the word Remote. 


Warning: Cannot print file(s) on local printer. 


You included the /PRINT switch in a COPY operation from a remote node to the 
local node. You cannot print remote files on the local printer. (However, you can 
print local files on a remote printer.) 


Warning: Cannot TYPE from one file to another. 
You included two file specifications with the TYPE command. 
Warning: Renaming files with wildcard specifications not supported. 


You tried to rename a file with the COPY command and used a wildcard in both the 
input file name and the output file name. 


Warning: File(s) will NOT be deleted after copy. 


The /DELETE switch was used as an invalid switch with the COPY command. 
/DELETE is only valid with /PRINT. 


Name is too long for local file. Limit is 12 characters. 
Enter local file name: 


You entered a file name that is too long for DOS to accept. The local file name must 
be 12 characters or less. 


Unable to make local file name from remote name: node-name::filename. typ 
Enter local file name: 


You omitted the local file name with the COPY command and NFT was not able to 
create a local file name from the specified remote file name. 
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B.3 File l/O Error Messages 


The messages listed in this section are all related to accessing local and remote files or 
submitting a remote command file. If you receive a remote node error message, refer to 
the documentation for that operating system or see your network coordinator for 
instructions on how to correct the problem. 


Examples of file I/O errors are improper file specifications or a file read error. Remem- 
ber that remote file I/O messages are displayed on two lines. The second line is a sec- 
ondary message that describes why the error occurred. Many of the secondary mes- 
sages can be displayed with more than one file I/O message. 


Cannot delete file: filename.typ 


NFT cannot delete the local file you specified because it is a directory file or has a 
Read Only protection. 


Error Closing File: node-name:: filename. typ 


NFT cannot close the remote file you specified. The secondary message explains 
the specific reason. 


Error Deleting File: node-name::filename.typ 


NFT cannot delete the remote file you specified. The secondary message explains 
the specific reason. 


Error In Directory of: node-name:: 


There is a problem with the remote directory you specified. The secondary mes- 
sage explains the specific reason. 


Error Opening File: node-name::filename.typ 


NFT cannot open the remote file you specified. The secondary message explains 
the specific reason. 


Error Reading from: node-name::filename.typ 


NFT cannot copy from the remote file you specified. The secondary message 
explains the specific reason. 


Error Submitting File: node-name::filename. typ 


NFT has a problem running the remote command file you specified. The secondary 
message explains the specific reason. 


Error Printing File: node-name::filename.typ 


NFT has a problem queuing the remote file to a printer. The secondary message 
explains the specific reason. 
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Error Writing to: node-name::filename.typ 


NFT cannot copy to the remote file you specified. The secondary message explains 
the specific reason. 


Error: Cannot SUBMIT local file. 
You tried to run a local command file. 
Error: Unable to type non-ASCll file: filename.typ 


You tried to type a file that has a non-ASCII format. NFT displays the name of the 
file you tried to type. 


File not found: filename.typ 


You tried to access a file that NFT could not find. The file may not exist, or you may 
have mistyped the file name. 


Unable to open file: filename.typ 


NFT cannot open the local file you specified. 
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B.4 Network Error Messages 


The error messages listed in this section are all related to network software including j 
temporary files created by NFT. 


Network errors pertain to network operation failures or rejections. For example, con- 
nection requests can be rejected by the network due to insufficient network resources 
or to an invalid node name. 


Allocation quantity too large. 

The disk on the remote system is too full to process your request. 
Host is down. 

You are trying to access a remote host and it is not in operation. 
Network is down. 


You are trying to perform network activity and the network is not currently avail- 
able. 


No route to host. 

This message is an indication of one of the following conditions: 

e The network driver is not loaded or you are not using the correct version. 

e §=6©The line state is OFF. 

e The remote host is currently unreachable. UO 
Problem with temporary file for remote file names. 


You are copying a file from a remote node, and you included a wildcard in the 
command. For example, COPY NODE::*.*. NFT first requests a directory list of the 
remote files. NFT then stores these file names in a temporary local file on the 
default disk. Ifa problem occurs with the temporary file due to a lack of disk space, 
for example, this message is displayed. 


Remote system DAP buffer size < 256. 


Two programs on different systems have such different buffer sizes that they can- 
not communicate with one another. 
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B.5 Secondary Error Messages 


Secondary error messages are displayed with remote file I/O messages. Many of the sec- 
ondary messages can occur with more than one file I/O message. Also, a file I/O mes- 
sage can be displayed with one of several secondary messages depending on the cause 
of the problem. 


Because bad record size 
The specified record size is either invalid or illegal for the specified operation. 
Because cannot assign address — possibly node name is undefined 


The network rejected an attempted connection because the remote node name did 
not correspond to any node name defined at the local node. 


Because cannot open file 

An error occurred on a file open operation. 
Because cannot position to end of file 

NFT cannot append the specified input file to the end of the specified output file. 
Because device is write locked 


The specified output file cannot be created because the output device is write 
locked. 


Because directory full 
You tried to copy a file to a remote node and the remote directory is already full. 
Because directory not found 


The specified directory does not exist on the node/device that was specified or 
defaulted in the file specification. 


Because disk quota exceeded 


You try to perform a remote file operation and there is no room on the remote 
disk. 


Because error in directory name 

The specified directory does not conform to the syntax of the target system. 
Because error in file name 

The specified file name does not conform to the syntax of the target system. 
Because error in record attribute 


You specified remote file record attributes (such as FORTRAN, implied line feed/ 
carriage return, embedded or VMS print file) that are not valid. 
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Because error in record format 


You specified a remote file record format (such as fixed, variable, VFC, or stream) 
that is not valid. 


Because file locked by other user 


Another user currently has the specified file locked or open for writing. You can 
also receive this message in a full directory listing. 


Because file not found 

The specified file or files do not exist. 
Because file read error 

An irrecoverable error has occurred while reading on the device. 
Because file write error 

An irrecoverable error has occurred while writing on the device. 
Because illegal record attributes 


The file’s record attributes (that is, FORTRAN, implied CR/LF, embedded, or VMS 
print file) are invalid or unsupported by NFT. 


Because incorrect user access information 


The network rejected an attempted connection because the specified access con- 
trol information (userid, password, and account) does not match a valid account 
on the remote node. 


Because invalid record format 


The file’s record format (that is, fixed, variable, VFC, or stream) is invalid or unsup- 
ported by NFT or the remote FAL. 


Because invalid wildcard operation 


The remote system rejects the specified wildcard as inappropriate for the specified 
operation. 


Because privilege violation 


An operation was specified for which you do not have privileges. 
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SETHOST Error Messages 


This appendix lists the error messages you may encounter when using the SETHOST 
utility. The SETHOST error messages fall into two categories. They are listed alphabeti- 
cally. 


Network error messages. 


These messages are displayed when you try to run SETHOST on a system where 
network support, or some part of it, is missing or not working properly. 


Execution error messages. 


You may encounter these messages when you attempt to perform a SETHOST 
function, such as redirecting input. 


C.1 Network Errors 


A network error consists of a pair of messages that are separated by a colon. The mes- 
sage format is: 


SETHOST specific message. : DECnet specific message. 
The first message can be one of the following SETHOST messages: 
SETHOST: Could not send BIND request accept message to host: 
SETHOST: Did not receive BIND request message from host: 
SETHOST ERROR checking for message from host: 
SETHOST ERROR checking for message from host: connection broken: 


SETHOST ERROR connecting to host: 

SETHOST ERROR receiving message from host: 

SETHOST ERROR sending message to host: 

The second half of the message string can be one of the following DECnet messages: 
Connect failed, Access control rejected. 


The remote host rejected the access control information supplied at log-in. 


Action to be taken: Check to see if you have a valid user name and password. Try again 
to log-in to the remote system. 


Connect failed, Connection rejected by object. 
The remote host rejected your attempt to connect to the system. 


Aciion to be taken: If you need assistance, contact the person responsible for your net- 
work. 


Connect failed, Insufficient network resources. 


There is a problem with the network. You will usually see this error when the max- 
imum number of links has been exceeded. 


Action to be taken: Increase the number of maximum links for DECnet—DOS by using 
the NCP DEFINE EXECUTOR command (refer to Chapter 2 for more information on | 
NCP commands). Reboot the system. a 


As an alternative, you can reduce the number of links you are currently using and then 
try to reconnect. 


Connect failed, Invalid node name format. 
You supplied an invalid node name. 


Action to be taken: A valid node name consists of 1 to 6 alphanumeric characters. At 
least one character must be alphabetic. Enter a valid node name. 


Connect failed, Invalid object name format. 
An invalid format was used for the object name. 


Action to be taken: If you need assistance, contact the person responsible for your net- 
work. 


Connect failed, Local node shutting down. 
Your local system is terminating network activity. 


Action to be taken: Try to log-in to the system once it resumes network activity. 


C-2 DECnet-—DOS User’s Guide 


Connect failed, No response from object. 
There is a problem with the network. 


Action to be taken: If you need assistance, contact the person responsible for your net- 
work. 


Connect failed, Node unreachable. 


The remote node is not available for network activity. It is also possible that DEC- 
net is not installed. 


Action to be taken: Make sure that DECnet is installed, and that the DECnet circuit is 
running. (You can check the circuit by using the NCP SHOW CIRCUIT STATUS com- 
mand.) Try to log-in to the system once it becomes operational again. 


Connect failed, Object too busy. 
There is a problem with the network. 


Action to be taken: If you need assistance, contact the person responsible for your net- 
work. 


Connect failed, Remote node shutting down. 

The remote node is terminating network activity. 
Action to be taken: Try to log-in to the system once it resumes network activity. 
Connect failed, Unrecognized node name. 


The system did not accept the node name that was supplied, or the node name was 
not defined in your DECnet NCP database. 


Action to be taken: A node name consists of 1 to 6 alphanumeric characters. At least 
one character must be alphabetic. Enter a valid node name. If the name is not defined in 
the database, use the NCP SET command to define the node you want to use. 


Connect failed, Unrecognized object. 


There is a problem with the network. The system did not accept your connection 
request. 


Action to be taken: If you need assistance, contact the person responsible for your net- 
work. 


Unrecognized error code (error code). 
The error code was not valid. 


You should not see this message. If this message does appear, contact the person 
responsible for your network. 
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There are also some network error messages which contain only one line of text. These 
messages include: 


SETHOST: Remote system does not support correct protocol version. WwW 
SETHOST: Remote system does not support SETHOST protocol. 

SETHOST ERROR: Could not process the initiate message. 

SETHOST ERROR: Protocol violation by host. 

SETHOST ERROR: Unknown protocol message from host. 


WY 
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C.2 Execution Error Messages 


The following error messages may occur when you attempt to use the SETHOST util- 
ity. 
Could not restore Session n from file SETHOST.n in the DECnet directory. 


SETHOST could not access the DECnet directory to restore your session. 


Action to be taken: Make sure the DECnet directory has been installed correctly. Then 
try again to restore the session. 


Could not save Session n to file SETHOST.n in the DECnet directory. 


SETHOST could not access the DECnet directory to save your session, or the disk 
may be full. 


Action to be taken: Make sure the DECnet directory has been installed correctly. If the 
disk is full, delete unnecessary files to create more disk space. Then try again to save the 
session. 


Could not write index file SETHOST.n. 


SETHOST could not access the DECnet directory to create an index file, or the disk 
may be full. 


Action to be taken: Make sure the DECnet directory has been installed correctly. If the 
disk is full, delete unnecessary files to create more disk space. Then try again to create 
an index file. 


Error writing session log file to disk. 


The disk may be full, or SETHOST could not access the DECnet directory to create 
a log file of your session. 


Action to be taken: If the disk is full, delete unnecessary files to create more disk space. 
Make sure the DECnet directory has been installed correctly. Then try again to create a 
log file. 


Session n deleted, connection has broken. 
DECnet has disconnected the network link. 


Action to be taken: None. SETHOST has updated the index file and deleted the session 
file that was saved. This is just an information message. 


Session n does not exist. 
There is no saved session with this number. 


Action to be taken: Try a different session number, or use the /SHOW switch to see 
which sessions do exist. 
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SETHOST could not open input file. 
Your attempt in redirecting input was unsuccessful. 


Action to be taken: Make sure the input file exists before attempting to redirect input 
from that file. 


SETHOST could not open log file. 


Your attempt in redirecting output to a specified file was unsuccessful. The disk 
may be full. 


Action to be taken: Make sure the disk is not full. Delete any unnecessary files and try 
again. 


Unrecognized Command. 

The command is not a valid SETHOST command. 
Action to be taken: Type SETHOST/HELP to view the valid SETHOST commands. 
Unrecognized nodespec. 

The nodespec is not valid. 


Action to be taken: Type SETHOST/HELP = NODESPEC to view proper nodespec 
formats. 


Unrecognized Parameter. 
The parameter you specified is not a SETHOST parameter. 
Action to be taken: Type SETHOST/HELP to view the valid SETHOST parameters. 
Unrecognized Help option; try typing just /HELP. 
The option you entered is not a SETHOST help option. 
Action to be taken: Type SETHOST/HELP to view the valid SETHOST help options. 
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NDU Error Messages 


This appendix lists the error messages you may encounter when using the NDU utility. 
The first section deals with Virtual Disk error messages, the second section lists Virtual 
Printer error messages. The NDU error messages fall into three categories. They are 
listed alphabetically. 


Command line error messages. 


These messages are displayed when you mistype part of a command line. The error 
message includes a circumflex ( *) which appears directly under the error, fol- 
lowed by explanatory text. For example: 


CLOSE DRIVE one 
*~ Disk DRIVE must be a single character. 


Network error messages. 


These messages are displayed when you try to run NDU on a system where net- 
work support, or some part of it, is missing or not working properly. 


Execution error messages. 


You may encounter these messages when you attempt to perform an NDU func- 
tion, such as CREATE or OPEN. 


D.1 Virtual Disk Error Messages 
The following error messages may occur when you perform operations on virtual 
disks. 

D.1.1 Network Errors 


A network error consists of a pair of messages that are separated by a colon. The mes- 
sage format is: 


NDU specific message. : DAP specific message. 
The first message can be one of the following NDU messages: 
CLOSE during DELETE function failed. 
CLOSE function failed. 
CREATE function failed. 
DELETE function failed. 
OPEN function failed. 
The second half of the message string can be one of the following DAP messages: 
A received DAP message was poorly formed. 


During the dialogue with the File Access Server on the remote node (which was 
necessary to execute your request), a message was received of the proper type but 
it did not contain the proper contents. 


Action to be taken: For an explanation of the DAP message, refer to the Appendix sec- 
tion of the DECnet-DOS Programmer’s Reference Manual. If you need additional 
assistance, contact the person responsible for your network. 


An unexpected DAP message was received. 


During the dialogue with the File Access Server on the remote node (which was 
necessary to execute your request), a message was received of the wrong type. 


Action to be taken: For an explanation of the DAP message, refer to the Appendix sec- 
tion of the DECnet-DOS Programmer’s Reference Manual. If you need further assis- 
tance, contact the person responsible for your network. 


Internal error. 
An internal error message was detected. 


Action to be taken: Contact the person responsible for your network for assistance. 
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The remote server’s buffer is too small. 


During the dialogue with the File Access Server on the remote node, which was 
necessary to execute your request, a message was received which included the 
maximum possible buffer size for the remaining messages. This size is too small to 
support the communication. 


Action to be taken: Contact the person responsible for your network for assistance. 
The remote server could not find that file. 
The NDISK file that you specified was not found at that remote node. 
Action to be taken: You must specify a file which exists. 
The remote server reports DAP error x:x. 


The remote File Access Listener is relaying a DAP error message to you. The error 
message consists of a pair of DAP error codes. The first error code indicates a spe- 
cific error type. The second error code identifies the specific reason for that error. 


Action to be taken: To determine the meanings of the displayed error codes, refer to 
the Appendix section of the DECnet-DOS Programmer’s Reference Manual. If you 
need further assistance, contact the person responsible for your network. 


The specified file is not a virtual disk file. 


The NDISK file that you specified does not have the proper attributes. This can 
happen if you make an error in the file name. 


Action to be taken: Specify a file which has been created with the CREATE command. 


NDU Error Messages D-3 


D.1.2 Command Line Error Messages 


The error messages listed in this section are all related to the syntax of a command line. 
ACCESS must be either RO or RW. 

You can only specify RO or RW as valid ACCESS options. 
Disk DRIVE name must be a single character. 

A disk drive’s name cannot exceed one alphabetic character. 
Initial ALLOCATION must be a decimal number. 

You can only specify a decimal value greater than 50 for initial disk allocation size. 
Unexpected syntax error. 

You incorrectly typed a command. 
Unrecognized command. 


You mistyped an NDU command or tried to use a command that NDU could not 
recognize. 


Unrecognized HELP option; try typing just HELP. 
You typed an invalid HELP option. Just type HELP for assistance. 
Unrecognized NDISK file name. 


A valid file name consists of 1 to 126 alphanumeric characters. The file name may 
include device and directory fields, but it must be in the proper format for the 
remote node’s system type. 


Unrecognized NODE name. 


A valid node name consists of 1 to 6 alphanumeric characters. It must contain at 
least one alphabetic character. The node name can also be a unique numeric 
address in the format of area.number. 


Unrecognized NPRINT file name. 


A valid file name consists of 1 to 126 alphanumeric characters. The file name may 
include device and directory fields, but it must be in the proper format for the 
remote node’s system type. 


Unrecognized Parameter. 


You supplied an invalid parameter with an NDU command. Type HELP for assis- 
tance. 


Unrecognized SHOW option. 


NDU could not recognize the option. The only valid option for the SHOW com- 
mand is STATUS. 
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Unrecognized USER name. 


f . ) NDU could not recognize the USER name. A valid USER’s name consists of access 
| | control information: user-id, password and account. Each field can include 1 to 39 
alphanumeric characters. Enter a valid user name. 
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D.1.3 Execution Error Messages 


The following error messages may occur when you attempt to execute an NDU com- 
mand or fail to install the virtual disk driver beforehand. 


ALLOCATION used for CREATE only, value IGNORED. 
The ALLOCATION parameter was not accepted with the command you specified. 


Action to be taken: The ALLOCATION parameter can only be supplied with the CRE- 
ATE command. You cannot use it with other NDU commands. 


All the drives are in use, cannot OPEN another drive. 
All four disk drives are in use. 
Action to be taken: Close one of the open drives before opening another. 
All the drives are in use, CREATE function not done. 
You cannot create a new virtual disk because all drives are in use. 
Action to be taken: Close one of the drives. 
Cannot CLOSE a drive, the disk driver is not installed. 
You cannot close a virtual disk without having the virtual disk driver installed. 


Action to be taken: Refer to the DECnet—DOS Installation Guide or the DECnet-Rain- 
bow Installation Guide for instructions on installing the Virtual Disk Driver. Install 
the virtual disk driver and run the NDU utility to close the drive. 


Cannot CREATE a drive, the disk driver is not installed. 
You cannot create a virtual disk without having the virtual disk driver installed. 


Action to be taken: Refer to the DECnet-DOS Installation Guide or the DECnet—Rain- 
bow Installation Guide for instructions on installing the Virtual Disk Driver. Install 
the virtual disk driver and run the NDU utility to create the disk drive. 


Cannot CREATE a disk file without including NDISK parameter. 
You cannot issue a CREATE command without the NDISK parameter. 


Action to be taken: Reissue the CREATE command, and specify the name of the file that 
will contain the virtual disk on the remote node. 


Cannot CREATE a disk file without including NODE parameter. 
You cannot issue a CREATE command without the NODE parameter. 


Action to be taken: Reissue the CREATE command, and specify the name of the remote 
node with NODE. 
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Cannot DELETE a disk file without including NDISK parameter. 
You cannot issue a DELETE command without the NDISK parameter. 


Action to be taken: Reissue the DELETE command, and specify the name of the file that 
will contain the virtual disk on the remote node. 


Cannot DELETE a disk file without including NODE parameter. 
You cannot issue a DELETE command without the NODE parameter. 


Action to be taken: Reissue the DELETE command, and specify the name of the remote 
node with NODE. 


Cannot DELETE, the disk driver is not installed. 
You cannot delete a virtual disk without having the virtual disk driver installed. 


Action to be taken: Refer to the DECnet—DOS Installation Guide or the DECnet- 
Rainbow Installation Guide for instructions on installing the Virtual Disk Driver. 
Install the virtual disk driver and run the NDU utility to delete the disk drive. 


Cannot open a drive, the disk driver is not installed. 
You have not installed NDU properly. 


Action to be taken: Refer to the DECnet-—DOS Installation Guide or the DECnet-Rain- 
bow Installation Guide for instructions on installing the Virtual Disk Driver. Repeat 
the procedure and run the NDU utility. 


Cannot open a drive without including NDISK parameter. 
You cannot issue an OPEN command without the NDISK parameter. 


Action to be taken: Reissue the OPEN command, and specify the name of the file that 
will contain the virtual disk on the remote node. 


Cannot open a drive without including NODE parameter. 
You cannot issue an OPEN command without the NODE parameter. 


Action to be taken: Reissue the OPEN command, and specify the name of the remote 
node with NODE. 


Drive name is already OPEN; CREATE function not done. 

The drive is already open. You cannot format the new data file. 
Action to be taken: Use the SHOW STATUS command to list the open drives. 
Drive name is already OPEN, cannot OPEN it again. 

The drive is already open. 


Action to be taken: You cannot open a drive that is already open. 
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Drive name is not a network disk. 
The drive name that you specified is invalid. 


Action to be taken: The drive name consists of one alphabetic character. Use the SHOW 
STATUS command to list the valid drive names. 


Drive name is not a network disk, cannot CLOSE it. 

You cannot close a drive which is not a virtual disk drive. 
Action to be taken: Use the SHOW STATUS command to list the open drives. 
Drive name is not a network disk, cannot OPEN it. 

You can only use the drive names listed by the SHOW STATUS command. 
Action to be taken: Use a proper drive name. 
Drive name is not a network disk, CREATE function not done. 

You can only use the drive names listed by the SHOW STATUS command. 
Action to be taken: Use a proper drive name. 
Drive name is not OPEN, cannot CLOSE it. 

You cannot close an unopened drive. 
Action to be taken: Use the SHOW STATUS command to list the status of the drives. 
Drive name is not OPEN, cannot DELETE its disk. 


You cannot delete a disk without having the drive opened. 
Action to be taken: Use the SHOW STATUS command to list the status of the drives. 


Drive name is too long. It can only be a single character. 


You supplied an invalid name for the disk drive. 


Action to be taken: A valid drive name consists of one alphabetic character. Use the 
SHOW STATUS command to list the valid drive names. 


Either DRIVE or NDISK must be specified, the CLOSE function not done. 


You cannot issue the CLOSE function without specifying DRIVE or NDISK as a 
parameter. 


Action to be taken: To perform the CLOSE function, you must specify either the name 
of the virtual disk drive or the file that will be the virtual disk on the remote node. 
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Length of NDISK parameter is too long. 
File name must be less than 127 characters. 


An invalid length was supplied for the file name. 


Action to be taken: The NDISK parameter specifies the name of the file which will be 
the virtual disk on the remote node. The valid range for the file name is 1 to 126 alpha- 
numeric characters. Enter a valid file name. 


Length of NODE parameter is too long. 
Node name must be less than 6 characters. 


An invalid node name was supplied. 


Action to be taken: A valid node name consists of 1 to 6 alphanumeric characters. It 
must contain at least 1 alphabetic character. Enter a valid node name. 


Length of USER parameter is too long. 
The string must be less than 120 characters. 


You supplied an invalid user name. 


Action to be taken: NDU could not recognize the USER name. A valid user’s name con- 
sists of access control information: user-id, password and account. Each field can 
include 1 to 39 alphanumeric characters. Enter a valid user name. 


NDISK not found, the CLOSE function was not done. 
Either DRIVE or NDISK must be specified, the CLOSE function was not done. 


Action to be taken: To determine which drive is to be closed, you must specify a drive 
name, an NDISK file specification, or both. 


The Disk Driver is not installed. 


You cannot create or use a virtual disk without first installing the Virtual Disk 
Driver. 


Action to be taken: Refer to the DECnet—DOS Installation Guide or the DECnet—Rain- 
bow Installation Guide for instructions on installing the Virtual Disk Driver. Repeat 
the installation procedure and then try to run NDU. 
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D.2 Virtual Printer Error Messages 


The following error messages may occur when you use the virtual printer feature. 


D.2.1 Network Errors 


A network error consists of a pair of messages that are separated by a colon. The mes- 
sage format is: 


NDU specific message. : DAP specific message. 

The first message can only be: 

OPEN/CREATE function failed. 

The second half of the message string can be one of the following DAP messages: 
A received DAP message was poorly formed. 


During the dialogue with the File Access Server on the remote node (which was 
necessary to execute your request), a message was received of the proper type but 
it did not contain the proper contents. 


Action to be taken: For an explanation of the DAP message, refer to the Appendix sec- 
tion of the DECnet—DOS Programmer's Reference Manual. If you need additional 
assistance, contact the person responsible for your network. 


An unexpected DAP message was received. 


During the dialogue with the File Access Server on the remote node (which was 
necessary to execute your request), a message was received of the wrong type. 


Action to be taken: For an explanation of the DAP message, refer to the Appendix sec- 
tion of the DECnet—DOS Programmer’s Reference Manual. If you need further assis- 
tance, contact the person responsible for your network. 


Internal error. 

An internal error message was detected. 
Action to be taken: Contact the person responsible for your network for assistance. 
The remote server’s buffer is too small. 


During the dialogue with the File Access Server on the remote node (which was 
necessary to execute your request), a message was received which included the 
maximum possible buffer size for the remaining messages. This size is too small to 
support the communication. 


Action to be taken: Contact the person responsible for your network for assistance. 
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The remote server could not find that file. 

The NDISK file that you specified was not found at that remote node. 
Action to be taken: You must specify a file which exists. 
The remote server reports DAP error x:x. 


The remote File Access Listener is relaying a DAP error message to you. The error 
message consists of a pair of DAP error codes. The first error code indicates a spe- 
cific error type. The second error code identifies the specific reason for that error. 


Action to be taken: To determine the meanings of the displayed error codes, refer to 
the Appendix section of the DECnet-DOS Programmer’s Reference Manual. If you 
need further assistance, contact the person responsible for your network. 
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D.2.2 Command Line Error Messages 
The error messages listed in this section are all related to the syntax of a command line. 
Unexpected syntax error. 
You incorrectly typed a command. 
Unrecognized command. 


You mistyped an NDU command or tried to use a command that NDU could not 
recognize. 


Unrecognized HELP option; try typing just HELP. 
You typed an invalid HELP option. Just type HELP for assistance. 
Unrecognized NODE name. 


A valid node name consists of 1 to 6 alphanumeric characters. It must contain at 
least one alphabetic character. The node name can also be a unique numeric 
address in the format of area.number. 


Unrecognized NPRINT file name. 


A valid file name consists of 1 to 126 alphanumeric characters. The file name may 
include device and directory fields, but it must be in the proper format for the 
remote node’s system type. 


Unrecognized Parameter. 


You supplied an invalid parameter with an NDU command. Type HELP for assis- 
tance. 


Unrecognized SHOW option. 


NDU could not recognize the option. The only valid option for the SHOW com- 
mand is STATUS. 


Unrecognized USER name. 


NDU could not recognize the USER name. A valid USER’s name consists of access 
control information: user-id, password and account. Each field can include 1 to 39 
alphanumeric characters. Enter a valid user name. 
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D.2.3 Execution Error Messages 


The following error messages may occur when you attempt to execute an NDU com- 
mand or fail to install the virtual printer driver beforehand. 


Cannot CLOSE the printer, the Printer Driver is not installed. 
You cannot close the printer without having the virtual printer driver installed. 


Action to be taken: Refer to the DECnet—DOS Installation Guide or the DECnet—Rain- 
bow Installation Guide for instructions on installing the Virtual Printer Driver. Install 
the virtual printer driver and run the NDU utility to close the printer. 


Cannot OPEN/CREATE the printer, the Printer Driver is not installed. 


You cannot open/create the virtual printer without having the virtual printer 
driver installed. 


Action to be taken: Refer to the DECnet-—DOS Installation Guide or the DECnet—Rain- 
bow Installation Guide for instructions on installing the Virtual Printer Driver. Install 
the virtual printer driver and run the NDU utility to open/create the printer. 


Cannot OPEN/CREATE the printer without including NODE parameter. 
You cannot issue the OPEN or CREATE command without the NODE parameter. 


Action to be taken: Reissue the OPEN or CREATE command, and specify the name of 
the remote node with NODE. 


Length of NODE parameter is too long. 
Node name must be less than 6 characters. 


You supplied an invalid node name. 


Action to be taken: A valid node name consists of 1 to 6 alphanumeric characters. It 
must contain at least 1 alphabetic character. Enter a valid node name. 


Length of NPRINT parameter is too long. 
File name must be less than 127 characters. 


You supplied an invalid file name for the NPRINT parameter. 


Action to be taken: A valid file name consists of 1 to 126 alphanumeric characters. The 
file name may include device and directory fields, but it must be in the proper format 
for the remote node’s system type. Enter a valid file name. 


Length of USER parameter is too long. 
The string must be less than 120 characters. 


You supplied an invalid user name. 


Action to be taken: NDU could not recognize the USER name. A valid user’s name con- 
sists of access control information: user-id, password and account. Each field can 
include 1 to 39 alphanumeric characters. Enter a valid user name. 
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Printer is not OPEN, cannot CLOSE it. 


You cannot close an unopened printer. ‘ 
Action to be taken: Use the SHOW STATUS command to list the status of the printer. 
The Printer Driver is not installed. 


You cannot create or use a virtual printer without first installing the Virtual Printer 
Driver. 


Action to be taken: Refer to the DECnet—DOS Installation Guide or the DECnet—Rain- 
bow Installation Guide for instructions on installing the Virtual Printer Driver. Repeat 
the installation procedure and then try to run NDU. 
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access control information 

Optional security information that you may need to access a remote node. 
account 

A character string consisting of 1 to 39 alphanumeric characters. 
adjacent node 

A node that you are physically connected to by a single line. 
alphanumeric 


A string of characters that contains letters (alphabetic characters), numbers 
(numeric characters), or a combination of both. The term alphanumeric is a con- 
traction of the words alphabetic and numeric. 


application 


A program (other than the operating system) that performs specific functions in 
order to meet user requirements. Applications available with DECnet—DOS include 
the Network File Transfer utility, the Network Device Utility, the Network Test 
Utility, and the SETHOST utility with network virtual terminal services. 


buffer 


A temporary storage area in a node’s memory. Buffers temporarily hold data being 
transferred to and from the node. The size and the number of buffers determine the 
amount of data that can be stored. 


circuit 


The communications path that operates over a physical line connecting two nodes. 
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command switch 


A word or character string that modifies the way in which a command operates. 
Typing the command DIRECTORY LONDON:: causes the system to display a full 
directory of all files located on node LONDON. When you modify the command 
using the /BRIEF switch, (as in DIRECTORY/BRIEF LONDON::), the system only 
displays the file names. 


communication path 


The route through hardware components and a cable that a message takes when 
sent from one node to another. 


counter 


A counter displays statistics about the flow of network messages for your node. 
The counters also record error conditions and accumulate their totals for you. 


DECnet 


A family of Digital software products that extend the capabilities of Digital com- 
puters to perform various operations over a network. DECnet provides many stan- 
dard applications for accessing files and databases that exist on other nodes. 


DECnet-DOS 


A set of software and hardware components designed for use with the IBM PC, the 
IBM PC/XT and the IBM Personal Computer AT. DECnet-DOS allows you to com- 
bine the capabilities of the IBM personal computers with DECnet applications to 
access the network as an end node. 


DECnet-—Rainbow 


A set of software and hardware components designed for use with the Rainbow 
personal computers. DECnet—Rainbow allows you to combine the capabilities of 
the Rainbow personal computers with DECnet applications to create end-node 
only networks. 


device 
A specific name for a disk or diskette that is currently storing data files. 
directory 


A specific name assigned to a collection of files stored on a disk or a diskette. A 
directory can also provide a list of the file names that it contains. 


emulate 


To imitate the performance of a terminal on another system. When your personal 
computer emulates a terminal on a host system, it performs many of the same func- 
tions as the host terminal. 
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end node 


A node that can only send and receive information for its own use. An end node 
cannot receive and then forward information intended for another node. Your 
personal computer is an end node. 


executor node 
A node that runs NCP commands. For a personal computer, this is the local node. 
file specification 


A complete file identification including an optional drive name and path name. The 
file specification must include at least a file name followed by an optional file type 
and version number. 


foreign file 


A file that has a format other than a format recognizable to DECnet—DOS. A foreign 
file specification must be enclosed in quotation marks (”) in a command line. 


host node 


A node on the network that your node can access for the purpose of sharing 
resources and information. 


line 

The physical line connecting the local node with the adjacent node. 
local node 

The node that you are currently using to communicate with other nodes. 
logging 


The process of recording information from an occurrence in the network. Logging 
is the process that generates a record of the event. 


loopback connector 


A hardware device that temporarily connects the output portion of a circuit back 
to the input portion of a circuit for the purpose of testing communication lines. 
The loopback connector verifies the operation of devices on the same communica- 


tions link. 


loopback test 


A test that sends an electronic signal over a hardware or software connection to 
verify the operation of devices along the communication link. Certain loopback 
tests require a loopback connector (see loopback connector). 
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modem 


A hardware device capable of changing communications signals from digital to 
analog and back to digital. The term modem is a contraction of the words modula- 
tion and demodulation. 


modulation 


The process of varying an original computer communication (digital) signal into a 
telephone communication (analog) signal. 


network 


A group of computers or systems that are connected together and can communi- 
cate with each other to share resources and information. 


network coordinator 


A person who assigns and updates node names and node addresses. The network 
coordinator also provides administrative assistance to network users. 


network link 


A temporary connection that establishes communication between programs run- 
ning on different nodes. The SETHOST utility with network virtual terminal ser- 
vices is a program that establishes a network link with another node, enabling you 
to log into a remote host system. 


node 


A computer with the necessary hardware and software to participate in a network 
with other computers. 


node address 


A unique numeric character string that identifies a node to other systems in the net- 
work. 


node definition 


A character string that identifies a particular node. The definition includes both the 
node address and the node name. 


node name 


A one to six alphanumeric character string (containing at least one letter) that 
identifies a node to other users in the network. 


password 


A character string that uniquely confirms your identity to the system. 
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process name 


A character string that identifies one particular user in a group of users sharing the 
same system. 


protocols 


Rules or formats that operating systems must follow to conduct effective commu- 
nications with other computers in a network. 


queue 

A waiting line for completing a service, such as transferring files. 
reachable node 

A node to which the local node has a usable communications path. 
remote node 

Any node on the network other than the node you are currently using. 
remote node list 


A list containing node definitions of other nodes that are available for communica- 
tion on the same network. 


router 


A DECnet node that can receive messages and information from one node and for- 
ward them to another node. 


routing node 


A DECnet node that can receive and forward information from one node to 
another. A routing node can perform other functions that are not limited strictly to 
routing information. 


segment 


A set of data that can be stored anywhere in memory, and can be retrieved at any 
time. 


TO file-id 


A qualifier that specifies the name of the output file which stores information 
resulting from the execution of an NCP command. 


topology 


The physical arrangement of nodes and connecting hardware that makes up the 
network. 


user name 
A character string consisting of 1 to 39 alphabetic characters identifying a user at a 


remote node. 
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Circuit 
defining parameters, 2—33, 7-35 
displaying information, 2-44 
zeroing counters, 2-51 

Circuit state, 2-12 

Circuit substates, 2-13 


Abbreviating NCP commands, 
Z=5 
Access control information, 2—8 
to 2-11, 2-21, 2-42, 3-2 
changing and overriding, 


gm 2-9 
| changing defaults, 3-4 Command files, 3-20 
defining with NFT, 3-3 submitting, 3-35 


displaying, 2-10, 3-5 Copying a local file to a remote node, 


displaying access defaults, 3 —18 

3-34 Copying a remote file to a local node, 
setting defaults, 3-33 ate 
specifying, 2-8 ee 3-6, 3-9, 3-10, 3-18, 


using defaults, 3-4 


Accessing a remote printer, 5-2 Counters, 2-51, 2-52, 2-54 


Accessing remote files, 3-1 D 
Account information, 2—8, 3-3 
Active nodes, 2-12 Data 
Adjacent node, 1-3 ASCII, 3-8, 3-10 
Appending files, 3-17, 3-22 Image, 3-8, 3-9 
ASCH file, 3-8, 3-10 DECnet 
terms and concepts, 1-1 
B DECnet—DOS 
Batch files capabilities, 1-3 
used with NCP, 2-2 DEnEIOn 
used with NDU, 5-3, 5-14 See TEOSSALY 
used with NFT, 3-2, 3-20 nee 
used with NTU, 7-6 FAL, 3-37 


“™ Job Spawner, 3-42 
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DECnet—DOS (Cont.) 
utilities (Cont.) 
MAIL, 6-1 
NCP, 2-1 
NDU, 5-1 
NFT, 3-1 
NTU, 7-1 
SETHOST, 4-1 
summary of, 1-4 
Deleting files, 3-18, 3-27 
Directories 
displaying files with wildcards, 
2-19 
displaying information, 3-19, 
3-28 
Disconnecting from a remote 
node, 4-29 
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Editing text during a remote 
session, 4-28 

End node, 1-3 

Event log 
continuous, 2-28, 7-31 
reading contents of, 2-31, 7-33 
sample, 2-29, 2-31, 7-32 

Executor node, 1-3 
clearing parameters, 2-20 
defining parameters, 2-24, 2-35 
displaying characteristics, 2-45 
displaying information, 2-11 
zeroing counters, 2—52 
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FAL, 3-37 
File Access Listener 
see FAL 
File operations 
logging, 3-20 
File specifications, 3-6 
for naming files, 3-6 
foreign, 3-7 
local, 3-6 
remote, 3-6 
using wildcards, 3-7, 3-8 
Files 
appending, 3-17, 3-22 
copying, 3-18, 3-24 


Index—2 


Files (Cont.) 
deleting, 3-18, 3-27 


displaying contents of, 3-19, 3-36 


listing, 3-17 
printing, 3-19, 3-32 
types of, 3-8 


G 


Getting help for 
MAIL, 6-7, 6-8 
NCP, 2-5, 2-27 
NDU, 5-6, 5-11, 5-16, 5-19 
NFT, 3-16, 3-31 
NTU, 7-7, 7-22 | 
SETHOST, 4-7, 4-15 


H 


Host node, 4-1 
disconnecting from, 4-29 


i 
Image file, 3-8, 3-9 


Installing virtual device 
programs, 5-2 
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Job Spawner, 3-42 
creating a DECSPAWN.DAT file, 


3-42 
starting, 3-42 
K 
Keys 
Line feed, 3-11 
L 
LAT 


displaying information, 2—47 
zeroing counters, 2—53 

Line 
defining parameters, 2-39 


displaying information, 2-12, 2-13, 


2-48 
setting line speed, 2-39 
zeroing counters, 2-54 
Line states, 2—12 
Line substates, 2—12 
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Listing files, 3-17 
Local file 
copying to a remote node, 3-6, 
5-10, 5-158 
Local files 
naming, 3—6 
providing access, 3-1, 3-37 
Local node, 1-3 
Logging file operations, 3-20 
Logical links 
and sockets, 2—38, 2-41, 7-40 
displaying information, 2-11, 
2-49 
setting maximum number, 2-24 


MAIL, 6-1 
getting help for, 6-7, 6-8 
initialization file, 6-1 
initialization file parameters, 
6-1 
CARBON__COPY, 6-3 
DEFAULT__NODE, 6-2 
EDITOR, 6-4 
PERSONAL__MESSAGE, 6-4 
REPLY__ADDRESS, 6-2 
qualifiers 
using, 6-7 
/EDIT, 6-7 
/SUBJECT, 6-7 
starting, 6-4 
using distribution lists, 6-5 
MAIL command summary, 6-8 
MAIL commands 
entering (from the command 
line), 6-4 
entering (from the mail prompt), 
6-5 


NCP, 2-1 
command format, 2—4 
exiting from, 2—3, 2-26 
getting help for, 2-5, 2-27 


NCP (Cont.) 
Starting, 2-2 
typing commands, 2-5 
NCP command parameters, 2—17 
NCP command summary, 2-15 
NCP commands 
CLEAR ACCESS, 2-18 
CLEAR EXECUTOR, 2-20 
CLEAR KNOWN ACCESS, 2-19 
CLEAR NODE, 2-21 
COPY KNOWN NODES, 2-22 
DEFINE CIRCUIT, 2-23 
DEFINE EXECUTOR, 2-7, 2-24 
DEFINE LINE, 2-25 
EXIT, 2-3, 2-26 
HELP, 2-5, 2-27 
MONITOR LOGGING, 2-28 
QUIT, 2-3 
READ LOGGING, 2-31 
SET ACCESS, 2=32 
SET CIRCUIT, 2-33 
SET ECHO, 2-34 
SET EXECUTOR, 2-35 
SET LINE, 2-39 
SET LINK, 2-41 
SET LINKS, 2-38 
SET NODE, 2-9, 2-42 
SHOW ACTIVE NODES, 2-12 
SHOW CIRCUIT, 2-44 
SHOW EXECUTOR, 2-11, 2-45 
SHOW KNOWN ACCESS, 2-46 
SHOW KNOWN NODES, 2-10 
SHOW LAT, 2-47 
SHOW LINE, 2-12, 2-13, 2-48 
SHOW LINK, 2-49 
SHOW NODE, 2-11, 2-50 
ZERO CIRCUIT, 2-51 
ZERO EXECUTOR, 2-52 
ZERO LAT, 2-53 
ZERO LINE, 2-54 
NCP error messages 
see Appendix A 
NDU, 5-1 
command format, 5-4, 5-14 
ending connection with remote 
disk, 5-7 
exiting from, 5-3, 5-14 
getting help for, 5-6, 5-11, 5-16, 
5-19 
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NDU (Cont.) 
prompts, 5-3, 5-14 


sample disk status display, 5-13 


5-20 
sample printer status display, 
3—155 5-20 
starting (remote printers), 5-14 
starting (virtual disks), 5-3 
NDU command summary 
remote printers, 5-16 
virtual disks, 5-6 
NDU commands 
CLOSE, 5-7, 5-17 
CREATE, 5-8, 5-18 
DELETE, 5-10 
EXIT, 5-3, 5-14 
HELP, 5-6, 5-11, 5-16, 5-19 
OPEN, 5-12, 5-18 
SHOW, 5-15, 5-20 
NDU error messages 
see Appendix D 
Network 
changing information, 2-13 
changing parameters, 2-13 
defined, 1-1 
displaying information, 2-11 
Network Control Program 
see NCP 
Network Device Utility 
see NDU 
Network File Transfer utility 
see NFT 
Network Mail Utility 
see MAIL 
Network Test Utility 
see NTU 
Network Virtual Terminal Utility 
see SETHOST 
NFT, 3-1 
abbreviating commands, 3-10 
abbreviating switches, 3-10 


access control information, 3-3 


command format, 3-10 
exiting from, 3-2, 3-30 

file operations, 3-16 
getting help for, 3-16, 3-31 
Starting, 3-2 

using long commands, 3-11 
using switches, 3-11 
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NFT command summary, 3-21 
NFT commands | 
APPEND, 3-17, 3-22 , 
COPY, 3-6, 3-18, 3-24 
DELETE, 3-18, 3-27 
DIRECTORY, 3-19, 3-28 
EXIT, 3-30 
HELP, 3-11, 3-16, 3-31 
PRINT, 3-32 
SET, 3-4, 3-5, 3-33 
SHOW, 3-5, 3-34 
SUBMIT, 3-35 
TYPE, 3-19, 3-36 
typing, 3-10 
NFT error messages 
see Appendix B 
NFT switches 
for APPEND, 3-22 
for COPY, 3-24 
for DELETE, 3-27 
for DIRECTORY, 3-28 
for HELP, 3-31 
for PRINT, 3-32 
for SUBMIT, 3-35 
summary of, 3-12 to 3-15 | | 
/BRIEF, 3-19 New 
/IMAGE, 3-10 
/NOCONVERT, 3-9 
/PRINT, 3-19 
Node 
clearing access control information, 
2-21 
clearing node name, 2-21 
clearing parameters, 2-21 
defining access control information, 
2-42 
defining node name, 2-42 
Node address, 2—7, 2-8 
Node name, 2-6, 2-7, 2-8 
Nodes, 1-1 
adjacent, 1-3 
defining address, 2-7 
defining name, 2-7 
displaying information, 2-50 
end, 1-3 
executor, 1-3 
host, 4-1 
local, 1-3 


remote, 1—3, 2-8 Nea 


Nodes (Cont.) 
routing, 1-3 
setting address, 2—6 
setting name, 2-6 
Nonstream file system, 3-9 
NTU, 7-1 
exiting from, 7-7 
getting help for, 7-7, 7-22 
overview, 7-2 
prestartup, 7-5 
starting, 7-6 
using commands, 7-7 
NTU command summary, 7-9 
to 7-10 
NTU commands 
CLEAR ACCESS, 7-13 
CLEAR ACCOUNT, 7-14 
CLEAR COUNT, 7-15 
CLEAR DEFAULTS, 7-16 
CLEAR LENGTH, 7-17 
CLEAR PASSWORD, 7-18 
CLEAR USER, 7-19 
CLEAR WITH, 7-20 
EXIT, 7-21 
HELP, 7-22 
LOOP CIRCUIT, 7-23 
LOOP EXECUTOR, 7-26 
LOOP LINE CONTROLLER, 
7-2] 
LOOP NODE, 7-28 
MIRROR, 7-30 
MONITOR LOGGING, 7-31 
READ LOGGING, 7-33 
SET ACCOUNT, 7-34: 
SET CIRCUIT, 7-35 
SET COUNT, 7-36 
SET ECHO, 7-37 
SET LENGTH, 7-38 
SET LINE STATE, 7-39 
SET LINK, 7-40 
SET PASSWORD, 7-41 
SET USER, 7-42 
SET WITH, 7-43 
SHOW ACTIVE LINKS, 7-44 
SHOW ACTIVE NODES, 7-45 
SHOW ADJACENT NODE, 7-46 
SHOW CIRCUIT, 7-47 
SHOW DEFAULTS, 7-48 


NTU commands (Cont.) 
SHOW EXECUTOR, 7-49 
SHOW KNOWN LINKS, 7-50 
SHOW KNOWN NODES, 7-51 
SHOW LINE, 7-52 
SHOW NODE, 7-53 
ZERO CIRCUIT, 7-54 
ZERO EXECUTOR, 7-55 
ZERO LINE, 7-56 

NTU error messages 
see Appendix A 


p 
Password, 2-8, 3-2 
Printing a file, 3-19 
Printing files, 3-32 
Prompts 

NCP, 2-2 

NDU, 5=3 

NFT, 3-2, 3-11 

NTU, 7-5 


R 
Reading input from a file, 2-34, 
Pins) 
Redirected input files 
used with NCP, 2-2, 2-34 
used with NTU, 7-6, 7-37 
Remote file 
copying to a local node, 3-9, 
3-18 
printing, 3-19 
Remote files 
accessing, 3-1 
Remote node, 1-3, 2-8 
displaying information, 2-11 
displaying names, 2—10 
naming, 2-8 | 
Remote printers, 5-2 
closing down connection, 5-17 
creating a print queue, 5-18 
opening a print queue, 5-18 
Routing node, 1-3 
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Server functions 
using the job spawner 
with DTR, 3-42, 3-43 
with FAL, 3-42 
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SET-Up U 
exiting from, 4-28 
recalling parameters, 4-28 
saving parameters, 4-28 


Username, 2-8, 3-2 


selecting parameter menu, V 
4-27 
setting VT 102 class terminal Virtual disk 
features, 4-26 deleting space, 5-10 
SETHOST, 4-1 Virtual disk volumes, 5-2 
command parameters, 4-2 Virtual disks 
latservicename, 4-8 creating, 5-8 
nodespec, 4-8 establishing connection with 
command switches, 4-2 virtual disk, 5-12 
/ABORT, 4-3 Ww 
/CTERM, 4-4 
(EDIT, 4-5 Wildcards 
/EXIT, 4-6 combining, 3-8 
/HELP, 4-7 in file specifications, 3-7 
/LOG, 4-9 question marks, percent signs, 
/SAVEDEFAULT, 4-10 and asterisks, 3-8 
/SESSION, 4-11 
/SHOW, 4-12 
/TAKE, 4-13 


exiting from, 4-29 
getting help for, 4-7, 4-15 
interrupting a session, 4-14 
menu, 4-14 
<A>BORT SESSION, 4-16 
<E>DIT, 4-15 
<H>ELP, 4-15 
<L>OG, 4-15 
<N>EW SESSION, 4-16 
<R>ECONNECT, 4-15 
<RETURN>, 4-15 
<S>ESSION, 4-16 
SETHOST error messages 
see Appendix C 
Stream file system, 3-9 
Switches 
NFT, 3-11 
SETHOST, 4-2 
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READER’S COMMENTS 


What do you think of this manual? Your comments and suggestions will help us to improve 
the quality and usefulness of our publications. 


Please rate this manual: 


Poor Excellent 
Accuracy 1 2 3 4 2 
Readability 1 2 3 4 5 
Examples 1 2 3 4 5 
Organization 1 2 3 4 5 
Completeness 1 2 2 4 5 


Did you find errors in this manual? If so, please specify the error(s) and page number(s). 
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General comments: 


Suggestions for improvement: 
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